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PREFACE 


Organization of This Book 
This book has the following major divisions: 


e “Introduction,” which describes the use of VSAM, how VSAM fits into the 


Required Reading 


This book describes the internal logic of the Virtual Storage Access Method 
(VSAM) and contains diagnostic information. It is directed to maintenance 
personnel and development programmers who require an in-depth knowledge 
of VSAM’s design, organization, and data areas. 


operating system, how VSAM interacts with the operating system and the 
user’s program, and the major components of VSAM. 


“Method of Operation,”’ which describes the functions performed by 
VSAM. 


“Program Organization,” which describes the information contained in 
VSAM program listings and the flow of control between modules. 


“Directory,” which lists VSAM modules and the method of operation 
diagrams related to each module. 


“Data Areas,” which describes control blocks used by VSAM and 
describes the format of VSAM data and index records. 


“Diagnostic Aids,” which contains useful information for locating the 
cause of problems in the VSAM procedures. 


“‘Glossary,”’ which defines terms relevant to VSAM, and lists abbreviations 
and acronyms used in this book and in the VSAM program listings. 


““‘Index,”’ which is a subject index to the book. 


The following book should be read and understood before using this one: 


¢ OS/VS Virtual Storage Access Method (VSAM) Programmer’s Guide, 


GC26-3838, which introduces VSAM concepts and contains definitive 
explanations of VSAM macros. 
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Related IBM Publications. 
e Introduction to the IBM 3850 Mass Storage System (MSS), GA32-0028 


¢ OS/VS2 MVS Mass Storage System Extensions: Communicator (MSSC), 
LY35-0038 


e OS/VS Mass Storage System (MSS) Planning Guide, GC35-0011 
¢ OS/VS Message Library: VS2 System Messages, GC38-1002 


¢ OS/VS Virtual Storage Access Method (VSAM) Options for Advanced 
Applications, GC26-3819 


e OS/VS2 Access Method Services, GC26-3841 

¢ OS/VS2 Catalog Management Cross Reference, SYB6-3843 

e OS/VS2 Catalog Management Logic, SY26-3826 

¢ OS/VS2 Checkpoint/Restart Logic, SY26-3820 

e OS/VS2 DADSM Logic, SY26-3828 

e OS/VS2 Data Areas, SYB8-0606 

¢ OS/VS2 I/O Supervisor Logic, S¥Y26-3823 

¢ OS/VS2 JCL, GC28-0692 

e OS/VS2 MVS Data Management Macro Instructions, GC26-3873 
¢ OS/VS2 Open/Close/EOV Logic, SY26-3827 

e OS/VS2 Supervisor Services and Macro Instructions, GC28-0683 


e OS/VS2 System Logic Library, Volumes 1-7, SY28-0713 through 
SY28-0719 (All seven volumes can be ordered as SBOF-8210.) 


¢ OS/VS2 System Programming Library: Debugging Handbook, Volume 1, 
GC28-0708 Volume 2, GC28-0709 (Both volumes can be ordered as 
GBOF-8211.) 


¢ OS/VS2 System Programming Library: Service Aids, GC28-0674 


e OS/VS2 System Programming Library: System Management Facilities 
(SMF), GC28-0706 


e OS/VS2 VSAM Cross Reference, SYB6-3842 


Using This Book 


This book is designed to be used with the VSAM program listings in the 
microfiche for VSAM and with OS/VS2 VSAM Cross Reference, 
SYB6-3842, also on microfiche cards. Cross-reference reports are described 
in ‘Microfiche Cross-Reference Aids” in “Diagnostic Aids.” 


The diagrams in ‘“‘Method of Operation” describe the major functions 
performed by VSAM; these diagrams are intended to be your key to a module 
name (and procedure name, as appropriate) in the listing. See “Reading 
Method of Operation Diagrams” in ‘‘Method of Operation” for a description 
of how to read these diagrams. For information on what is available in the 
program listings, see “Module Prologues’”’ in ‘‘Program Organization.” 
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SUMMARY OF AMENDMENTS 


Release 3.8 


OS/VS2 MVS Data Management Support for the Mass Storage 
System (MSS) Extensions Program Product Number 5740-XYG 


MSS Extension Stage by Key Range 


Stage by key range provides VSAM support for new MSS applications. Two 
new interfaces with three new macros allow users to prestage data. Prestaging 
allows data extents to be acquired in advance of the data’s actual use. This 
reduces the number of page faults that might occur during processing. This 
function applies to MVS only. 


Document Changes (July 1978) 


This technical newsletter incorporates and replaces all previous SU 
information in this publication. Please replace identically numbered pages. 
Also, minor technical changes have been added. Revision bars appear beside 
all technical changes. 


Changes for ASM Support 


VSAM resources belonging to an Auxiliary Storage Management (ASM) RPL 
can be released. 


OS/VS2 MVS Data Management (VS2.03.808) 


Alternate Key Support 


Feedback code 08 (paired with the 0 indicator in register 15) has been 
changed. For GET requests, the code indicates that a duplicate key follows; 
for PUT requests, it indicates that a duplicate key was created in an alternate 
index with the nonunique attribute. 


OS/VS2 MVS Supervisor Performance #2 (VS2.03.807) 


Muttiple Key Support 


Multiple key support provides the ability to acquire an independent, global 
shared resource pool for each of the system keys 0 through 7. Changes 
include: 


e New fields and bit settings in AMBXN, CSL, HEB, VGTT, VSRT, and 
WSHD 


e Changes to Method of Operation diagrams ADS, AF, and AH2 
e Change ACBERFLG code 204 (CC) to reflect protection keys 0-7 
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SUSPEND/RESUME Processing 


Support for ASM Rewrite 


Document Changes 


Control Interval Split 


Release 3.7 


SVC 121 has been modified to use SUSPEND/RESUME, which are 
supervisor functions. SUSPEND places a specified request block in a 
suspended state; RESUME removes it from a suspended state and attempts to 
give control directly to the request block. VSAM Record Management has 
been changed to use SUSPEND/RESUME for synchronous processing. 
Specifically, new indicators have been defined in the IOMB and the PLH. 


The support for ASM Rewrite allows the defining and preformatting of Swap 
spaces and treats SYS1.STGINDEX as a system data set. New fields and bit 
settings have been defined in the ACB, AMB, AMBL, OPW, and VGTT. 


Before VSAM splits a control interval, VSAM writes the control interval to 
the direct-access device with the CIDF “busy flag” set on. When VSAM 
completes the control interval split, VSAM sets the busy flag off. Whenever a 
control interval with a busy flag is accessed, VSAM detects a previous control 
interval split interruption and attempts to remove any dupicated records from 
that control interval. 


Control Blocks in Common (CBIC) 


This MVS-only function allows the user to specify that for data sets being 
processed with the improved control interval (ICI) option, all VSAM control 
blocks are to be built in common storage area (CSA). 


SHOWCB Support for High-Allocated RBA 


By specifying a new keyword (HALCRBA\) in the FIELDS operand of the 
SHOWCB-ACB macro, the user can learn the high-allocated RBA for either 
the data or the index component. Whether the data or index RBA is returned 
is determined by the specified (or defaulted) content of the OBJECT 
operand. 


VSAM SNAP Dump Facility 


To increase the serviceability of VSAM, the VSAM SNAP dump facility has 
been added to provide hexadecimal dumps of VSAM-owned control blocks in 
CSA. Included in the dump are: 


« The JSCBSHR field of the JSCB (used by VSAM to locate the VAT) 


e The control blocks for open VSAM data sets processed with the global 
shared resources (GSR) option 


e The control blocks making up the GSR pool 


e The VGTT chain for the ASCB associated with the TCB being dumped 
and any PSBs associated with these VGTTs 
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The dump facility is described in “Diagnostic Aids.”’ 


Control Block Manipulation Macros 


Changes to support improved control block manipulation macro processing 
were made in 


e Diagrams CA and CB 


e “Data Areas,’’ where KEYWDTAB, a branch table that controls execution 
of IDA019C1 and supports processing of the control block macros, is 
described 


e “Diagnostic Aids,” where a new return code, issued when a block to be 
displayed or tested does not exist because the data set is a dummy data set, 
has been added 
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Diagram AB. VSAM Overview 
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Diagram ACI. VSAM OPEN: Connect a User to a VSAM Data Set 
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. 2 
Register 9 Entry in TIOT VSAM Open Processing 


For Catalog or 
SCRA t Password ee . fo 
4. Initialize tor processing the user ACB. 
(1720) 5. Mount and verity volumes. ACB 
DD Entry 23X26) 6. Open the object. 
for Data : : ACBDEB 
Set’s UCBs B0\39) 7. If a base cluster is being opened for output 


and has an upgrade set, open the upgrade 


Register 4 set, 
(46) 8. If the dsname on the DD statement names 
—_— a path, open the alternate index associated 


Common Work Area 


_ 
DSNAME 6 05256) 9. Prepare for subtask sharing and job step 


term in ation . BALAAASLASSLEALSALELLELELESESSRERERE SER ERRERESEERE EEE DEERE EE TE REE EY 


Se» © @OOC 


with the path. 


SLPLL LL LLY 


S) 


—— 10. Terminate Open processing. 
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Notes for Diagram AH1 


The VSAM Task Close Executor (IDAOCEAZ2) gets 
control from the VS2 Data Management Resource 
Manager (IFGOTCOA, also called VS2 Task Close) for 
normal or abnormal termination of a task or of an 
address space, including ‘“‘out-of-core” ABEND. 


1 
2 


© OBOxA HA A hh & 


IDAOCEA2 
IDAOCEA2?: JSTERM 


RMPLTCBA gives the location of the terminating 
TCB. TCBOTC indicates whether the region control 
task is being terminated. 


IDAOCEA2: JSTERM calls NMEMTERM 
IDAOCEA2: JSTERM calls FALLVGTT 
IDAOCEA2 

IDAOCEA2: AMEMTERM calls FALLVGTT 
IDAOQCEA2: AMEMTERM calls SCANGSR 
IDAOCEA2 

IDAOCEA2: NMEMTERM calls FALLVGTT 


10 IDAOCEA2: NMEMTERM calls SCANGSR 
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Diagram AH2. Recovery Termination: VSAM Task Close Executor 


Free Storage (4X6 9 ) 


ASCB CVT 


" (=> 12. Remove the chain of VSAM global termination 


tables from the address space control block to ASCB 


the module work area. LLALPAPAAAALAALAAL A AAA A A 2 oA, 
AMCBS 


CBSVUSE | Repeat steps 13—17 for each VGTT in the chain. 


>] 13. If the VGTT is fora global resource pool, LELLLA LAG @ 
decrement its use count, and free the VGTT . gage 


14. If the VGTT is for data sets that failed to close, 

free storage allocated for them in the common 

service urea or the system queue area (global 

storage), and free the VGTT. BAAAAAAAAZ 


. If the VGTT is for a local resource pool, free 
the VGTT and the lLOSB, SRB, and PFL 
PONENGQ SMO AA AAAS ASSSASSSSPSSASAPASAAPPPPPLAA 


VGTTs 


SAA, 


Wnt 


Z 

y 

G 

Global : : y 

VGTI Giorave . If the VGTT is for a catalog, a catalog recovery Z 

as for the area in system storage, the mass storage volume A | 
Aaa Local inventory data set, or a data set that-was pro- Z reed Storage 

(orgies cessed with global shared resources, free storage Z [ a 
Protected vol obtained during open, the protected sphere A, | | 
Sphere Block block, the base information block, and the Z | | 
VON LLL LLL SSL SL LSS SSSA SSSS SSS 2 A~/7777~7777e | 
noe . If the VGTT is an SBKR (Stage by Key Range) | 
EBeNE type, VGTT then free this VGTT and adjacent es ee a 


Subpool 
Size, Key 
Address 


storage obtained by IDAOQI92E. 


. Return to the caller. 
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Notes for Diagram AH2 
12 IDAOCEA2: FALLVGTT 


The pointer in the address-space control block to the 
first VGTT in the chain of VGTTs is removed. 
MWANVGTT is pointed to the first VGTT to make a 
local VGTT chain. 


In processing each VGTT in the chain (steps 13-16), it is 
made the current VGTT by pointing MWANVGTT to 
the next one, until there is no next one (in which case 
MWANVGTT is set to 0). 


13 IDAOCEA2: FALLVGTT calls VDECHAIN, which calls 
DECGVSRT 


If the AMCBS VSRT use count for the particular key 
isn’t 0, it is decremented by the amount in the current 
VGTT. If the use count becomes negative, it is set to 
0. 


14 IDAOCEA2: FALLVGTT calls FOPEN, which calls 
FREECORE 


A data set may not be closed because it was only 
partially opened or End of Volume or Close failed. 
The header elements in header element blocks 
describe storage that has been obtained for each data 
set. ““Virtual-Storage Management” in ’’Diagnostic 
Aids” describes HEBs and indicates what subpools 
contain each type of control block. 


FOPEN uses the VS2 GDT (global data area) to 
determine the address boundaries of global storage. If 
there is a protected sphere block, FOPEN processes 
each header element in it, using HEBCNT as an index. 
If the storage indicated in a header element is within 
the boundaries of global storage and in subpool 231, 
239, 241, or 245, FOPEN uses its key to free it. After 
all HEBs are processed, FOPEN frees the protected 
sphere block and the VGTT. 


15 IDAOCEA2: FALLVGTT calls FLSR, which calls 
FREECORE 


When a local resource pool is built (during BLDVRP 
processing), storage in the system queue area is 
obtained for each trio of IOSB-SRB-PFL, and a VGTT 
is prefixed to each. 


16 IDAOCEA2: FALLVGTT calis FCTLG 


At the end of Open processing for a catalog, a catalog 
recovery area in system storage, or the mass storage 
volume inventory data set, Open frees the VGTT, so 
IDAOCEAZ cleans up for these only for termination 
that occurs during Open processing. 


C 


17 IDAOCEA2: FALLVGTT calls FSBKR 


When obtaining storage for ECBs to use with 
ACQUIRE requests, IDA0192E concatentates a 
VGTT to the ECB storage. If the SBKR request never 
completes, IDAOCEA2 will free this subpool 241 
storage. 
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Diagram AH3. Recovery Termination: VSAM Task Close Executor 


QD? 


VT Force Deletion of Global Resource Pool 


t AMCBs 
Vv 


__|—718. Is there a global resource pool? 


CVT 
t AMC Bs 


AMCBs es No Yes AMCBs 
— 
» CBSVPTR=0 _— ‘VSRT< 
CBSVUSE 
> y 19. Did the address space being terminated 
tVSRTs A) build the resource pool? 
- 
% No Yes VSR 
sae _ sar SRT 
rs a _ as 20. Indicate that the resource pool is VSRTASCB=0 
dl eligible to be deleted after all data PZZZZZZZZZZD| NV SRTASCB=0 
| VSRTASCB sets being processed with it have 
VSRTASCB —_— 
ee been closed. 
tWSHD a ee 
| 1WSHD >21. Has the address space that built the resource 
3 oe 9 
tCPA WSHD t Working pool already been terminated? 
Storage No Yes 
af — 
. < 1 . . 
WSHD Working Storage 22. Have ail data sets being processed with 
t Working the resource pool been closed? 
Storage No Yes 
t Working | 
Storage CSLs 
> 23. Dump the control blocks of the VSRT 
Working resource pool. [— i 
Storage 24. Delete the resource pool. LLLP, : 
25. Inform the operator of the forced ee | 


Storage deletion. 


26. Return to the caller. 


Console 


Message 
to Operator 


Storage 
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Diagram BA. Record Management Table of Contents 


VSAM Record 
Management 
Overview 
Diagram BB 


ISAM 
Interface 


VSAM 


Overview 


Diagram AB Diagram BU 


PUT Macro 


GET Macro 
Processing 


GET Macro 
Processing 
(Sequential) 
Diagram BD 


(Direct) 
Diagram BC 


Creating a Key-Sequenced Data Set 


Processing ERASE Macro 


(Entry Se- 
quenced) 
Diagram BE 


Processing 
Diagram BI 


ENDREQ 
Macro 
Processing 
Diagram BK 


POINT Macro 
Processing 
Diagram BJ 


Modifying a Key-Sequenced Data Set 


CHECK Macro 
Processing 
Diagram BL 


Creating or Modifying a Relative Record Data Set 


PUT Macro 
Processing 
(Key Se- 
quenced) 
Diagram BF 1 


Getting a New 
Control Interval 
Diagram BG1 


Creating 
Index Records 
Diagram BG3 


Getting a New 
Control Area 
Diagram BG2 


Updating an 
Index Structure 
Diagram BG4 


PUT Macro 


Processing Macro 
(Insert) Processing 


PUT or ERASE 


PUT Macro 
Processing 
(Insert) 
Diagram BH1 


Creating 
Space for 
Insertions 
Diagram BH3 


Inserting an 
Index Entry 
Diagram BH6 


Splitting a 
Control Area 
Diagram BH4 


Updating 
the Index 
Structure 
Diagram BH8 


Splitting an 
Index Record 
Diagram BH9 


PUT Macro 
Processing 
(Modify) 
Diagram BH2 


GET or PUT Macro 
GETIX Macro Processing 
Processing (Create) 
Diagram BN1 Diagram BN2 


Processing with Shared Resources 


MRKBFR Macro WRTBFR Macro 
Processing Processing 
Diagram BPI Diagram BP2 


Major Subroutines 


Upgrading an 
Alternate 
Index 
Diagram BR 


Processing 
a Path 
Diagram BQ 


End of Volume 


VERIFY 
Processing 
Diagram BM 


Processing by Control Interval 


PUT or PUTIX 
Macro Processing 
(Update) 
Diagram BN3 


SCHBFR Macro 
Processing 
Diagram BP3 


Buffer 
Management 
Diagram BS 


(Modify) Processing with a 3850 MSS 


Diagram BO2 


Diagram BO! Allocating Addi- 


tional Space toa 
VSAM Object 


Obtaining the 
VSAM Object’s 


Next Volume 


CNVTAD MNTACQ ACQRANGE 
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Macro 


Processing 
Diagram BVI 


Macro Macro 
Processing Processing 
Diagram BV2 Diagram BV3 


Diagram BT1 


Diagram BT2 
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Diagram BB1. VSAM Record Management Overview 


SAY 


Register 0 > 1. Is the request a CHECK or ENDREQ? 
\ 
User’s Virtual Storage \ User’s Virtual Storage 


. Initialize the RPL(s) in the request-string. LLLLZLLALLPIIPPIPI ALIS 


. Assign a placeholder to the request-string. G2Z2ZeZZeZePZPPFZS 


. Ensure that the request is consistent with the 
data set’s characteristics. 


5. Initiate request processing. (Continued on Diagram 
BB.) 


ANANANAANAALNAAL 


1 RPL(ist) 


VSAM Record-Management Processing by Request 
fee 


Type 


GET Macro Processing: 
for direct requests (RPL OPTCD=(DIR)) Diagram BC 
for sequential requests (RPL OPTCD=(SEQ)) Diagram BD 
(See also “Control-Interval Access Processing’’.) 

PUT Macro Processing: 
for entry-sequenced data set processing Diagram BE 


for creating key-sequenced data set Diagram BF 


[Diagram BC_| 
[Diagram BD 
[Diagram BE _| 
[Diagram BF 
for inserting records in key-sequenced data set 
for modifying records in key-sequenced data set 
for inserting records in relative record data set 
for modifying records in relative record data set 
(See also ““Control-Interval Access Processing’’.) 
ERASE Macro Processing: 


POINT Macro Processing: Diagram BJ 
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Diagram BB2. VSAM Record Management Overview 


VSAM Record-Management Processing by Request 
Type (continued) 


ENDREQ Macro Processing: 
for request processing related to an old data set Diagram BK 1 


for request processing related to a newly created 
data set Diagram BK2 


CHECK Macro Processing: Diagram BL 
VERIFY Processing: Diagram BM 


Control-Interval Access Processing: 


for retrieving control intervals Diagram BN 1 
for creating a data set Diagram BN2 

’ for updating control intervals Diagram BN3 
MRKBFR Macro Processing: >| Diagram BP] 
WRTBFR Macro Processing: Diagram BP2 
SCHBFR Macro Processing: Diagram BP3 
TERMRPL Macro Processing: Diagram BW 
CNVTAD Macro Processing: Diagram BX2 
MNTACQ Macro Processing: Diagram BX3 


ACQRANGE Macro Processing: Diagram BX1 
Path Processing: 
for processing a request to guin uccess to a 
base cluster through an alternate index Diagram BQ 
Upgrade Processing. 


for upgrading a changed base cluster’s alternate 
index(es) Diagrum BR 


Buffer Management: Diagram BS 
End-of-Volume Processing: 
for obtaining the next volume Diagram BT | 
for allocating additional space Diagram BT? 
ISAM-Interface Request Translation for QISAM Diagram BU] 
ISAM-Interface Request Translation for BISAM Diagram BU2 


« 
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Diagram BB3. VSAM Record Management Overview 


User's Virtual Storage 


6. When the request isa CHECK or ENDREQ. ee 


7. When request is MNTACQ or ACQRANGE, (11) 


post request as complete. —w* 


Common Termination of Request Processing 


8. Post the request as complete. PAA PPPPPAIAP2ZAASLSO 
& 


9. Reinitiate request processing until all RPLs in the 
request-string are processed. 


Request- 
Pending 
lag 


. When the request-string processing is synchronous. 
ensure that its processing is completed. 


. When another request-string has been deferred as 
a result of current request-string processing, pass 
control to the deferred request. 


12. Return to the module that issued the macro 
being processed. 


QUANAAANALALALAALAALLALLLLALLAL 


User’s Virtual Storage 


Wait List 


Subpool 241 
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Notes for Diagram BJ 
1 Keyed Processing—Key-Sequenced Data Set 


IDA019RA 


When the request is keyed, an index search must be 
performed. The index level where the search begins is 
determined as follows: 


e For skip-sequential processing, the index search 
starts at the sequence set. The search normally starts 
at the index record pointed to by the current PLH. If 
the PLH is invalid, the search starts at the first 
record in the sequence set. 


e For direct processing, the search starts at the highest 
level of the index. 


IDAO19RA calls IDA019RB which calls IDA019RZ 
(IDAGRB) 


The index record at which the search is to stait is 
moved into an index buffer. 


IDA019RB calls IDA019RC 


The index record is searched for an entry that is 
greater than or equal to the search key. 


IDA019RB 


When the search is unsuccessful, the next record in 
logical sequence is searched. If the search is successful 
and a lower index level exists, the search is performed 
on the index records in the lower level. 


Keyed Processing—Relative Record Data Set 
IDA019RR 


The relative record number that is specified as a 
search argument is converted to the RBA of the 
control interval that contains the record, plus the 
offset of the record in the control interval. 


IDAO019RR calls IDAO1I9SRR (IDARRDRL) 


If the RBA is within the data set, the control interval’s 
contents are retrieved. If the RBA is not within the 
data set, then: 


e With KGE, end-of-data is indicated and 
positioning is established at the end of the data set 


e Without KGE, no-record-found is indicated 


C 


Addressed Processing 
IDA019RA 
The RBA that is specified as a search argument is 


converted into the RBA of the boundary of the control 
interval that it falls within. 


IDAO19RA calls IDA019RZ (IDAGRB) 
Relative Record Processing 

IDARRDRL calls IDA019RZ (IDAGRB) 
The control interval is read by RBA. 
IDA019RA 


The control interval is scanned to determine whether 
the key or RBA provided as a search argument is 
within the retrieved control interval. (Note: The RBA 
must represent a valid record boundary within the 
control interval.) 


When the key search is unsuccessful, a test is made to 
determine whether a control interval split has been 
performed by another request-string operating 
concurrently with the current request. If a split has 
occurred, processing returns to step 1 to perform a 
new index search. 


Relative Record Processing 
IDA019RR: IDARRDRL 


Positioning is established by saving in the PLH 
pointers to the record and its RDF and the RBA of the 
control interval. 
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Diagram BK1. ENDREQ Processing 


Noncreate 


User’s Virtual Storage 


Data Buffer 


Data Buffer 


. When processing of the current request is not 


complete, issue a WAIT macro against the ECB 
or list of ECBs. 


. Write any unwritten data buffers to the data set. 
. Perform [/O-error processing if necessary. 


. Return to the user’s program or to Close. 


New or Modified 


Control Intervals 


VSAM 
Data Set 


3ed 
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The placeholder (PLH) for the request string 
associated with the ENDREQ request is located by 
searching the placeholder list for a placeholder that 
points to the RPL identified by the ENDREQ. 


IDA019RP: IDAENDRQ 


Other RPLs (if any) in the request string are prevented 
from being processed by setting a flag in the 
placeholder that indicates that an ENDREQ request is 
being processed. (Note: Once a request-string starts 
processing, it continues until all of the RPLs in the 
string are processed or until an ENDREQ is issued. 
When an ENDREQ is issued, processing against the 
request-string is terminated when processing of the 
current RPL in the string has completed.) If the 
current request is not complete, the WAIT is issued to 
ensure completion. 


IDAO019RP: IDAENDRQ calls IDA019SM if a 
previous request was MNTACQ or ACQRANGE to 
issue multiple WAIT for list of ECBs. 


IDA019SM issues SVC 109 routing code 6 which calls 
IGX00006 and then IDA0192E to freemain the WAIT 
list and the ECBs. 


IDA019RP: IDAENDRQ 


Before performing any I/O, the processing is forced 
into synchronous mode to ensure that control is not 
returned to the user until I/O associated with the 
ENDREQ request is completed. When I/O is 
completed, asynchronous processing is restored if the 
processing was previously asynchronous. 


IDA019RP: IDAENDRQ (calls IDA019RZ 
(IDAWRBFR)) 


All unwritten data buffers associated with the current 
placeholder are written. 


IDAO19RP: calls IDAO19R5 


The buffer control block (BUFC) chain for the 
I/O-Management block (IOMB) in error is searched 
for a BUFC with an error indicator. 


IDA019R1: RIENDREQ (calls IDA019RS5) 


Error conditions are analyzed and an error message is 
built. 


IDAO19RP calls IDA019R5 (IDAEXITR) 
For processing if a SYNAD routine exists. 


Notes for Diagram BK1 4 IDAO019RP: IDAENDRQ (calls IDA019RZ (IDASBF)) 
1 IDAO19R1: FINDOPLH Excess data buffers are released from the current 
placeholder. 


IDA019RP: IDAENDRQ 


The placeholder is released from the current request 
string. 
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Diagram BK2. ENDREQ Processing 


Create 


BB2 
User’s Virtual Storage 5 


RPL ECB 


a. ee 


Index Buffer(s) 


Index Record 


Data Buffer(s) 


Data Control Interval 


Preformat Work Buffer 
a ee Ne” 


0’s CIDF 


— — — —> 5. When processing of the request associated with 
the ENDREQ request is not complete, issue a 
WAIT macro against the ECB. 


6. Write the current index record, if necessary, and 
write any unwritten data buffers. 


7. When the nonrecovery option is specified (SPEED= 
ON), convert unused control intervals in the last- 
used control area to freespace. 


8. Return to the user’s problem program or to Close. 


Preformatted 


Data Set 


Y VSAM 


Unused and 
Preformatted 
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Notes for Diagram BK2 
5 IDA019R1: FINDOPLH 


The placeholder for the request string associated with 
the ENDREQ request is located by searching the 
placeholder list\for a placeholder that points to the 
RPL identified by the ENDREQ. 


IDA019RP: IDAENDRQ 


Other RPLs (if any) in the request string are prevented 
from being processed by setting a flag in the 
placeholder that indicates that an ENDREQ request is 
being processed. (Note: Once processing for a 
request-string starts, it continues until all of the RPLs 
in the string are processed or until an ENDREQ is 
issued. When an ENDREQ is issued, processing 
against the request-string is terminated when 
processing of the current RPL in the string has 
completed.) If the current request is not complete, the 
WAIT is issued to ensure completion. 


The processing for step 6 ensures that the index entry 
for the last data control interval in the current data 
buffer for the current control area will fit in the index 
record for the current control area. Otherwise, when 
processing is resumed and when the dummy entry in 
the index record does not have space for the key, the 
data control interval would have to be moved to a new 
control area and have its index entry placed in the 
index record for the new control area. 


IDA019RP calls IDAO19RG 


Before writing the index buffer, the following 
processing is performed: IDA019RG checks the 
leftmost entry, a dummy entry for the current control 
interval, in the index record to determine whether a 
maximum length key will fit in the remaining index 
record freespace. If there is adequate space to insert a 
key, IDA019RG writes out the current index record 
and frees the index-create work area(s) (ICWAs). 


If there is inadequate space to contain a key for the 
control interval in the current data buffer, IDAO19RP 
calls IDA0O19SA, which recalls IDAO19RG, in order to 
have the entry inserted into the index record. 
IDAO19RG returns a no-fit indicator to IDAO19SA, 
which forces an end-of-control-area situation for 
IDA019SA (EOCA) processing. In response to the 
no-fit indicator, IDA019SA (EOCA) writes out any 
full data buffers (less the current data buffer) to the 
data set and acquires a new control area. 


7 IDAO19RP calls IDA019RZ (IDAWRBFR) 


8 IDAOI9RP calls IDAO019RK 
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Diagram BL. CHECK Processing 


User’s Virtual Storage 


Post Bit 


RPL 


Error Flag 


BB2 
5 


—> 1. When the request’s ECB is not posted as being 
complete, a WAIT macro is issued against the 
ECB or list of ECBs for MNTACQ or 
ACQRANGE requests. 


— > 2. Perform error processing if necessary. 


3. Return to the user’s processing program. 
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Notes for Diagram BL 
1 IDA019R1: FINDOPLH 
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The placeholder for the request-string associated with 
the CHECK request is located by searching the 
placeholder list for a placeholder that points to the 
RPL identified by the ENDREQ. 


IDAO19R1: RICHECK 


A WAIT macro is issued to ensure that the 
asynchronous request, for which the CHECK was 
issued, has completed. 


IDAO19R1: RICHECK 


Also performs CHECK processing for CNVTAD, 
MNTACQ, and ACQRANGE. If the request was 
CNVTAD, a WAIT is issued. 


RICHECK calls IDA019SM 


If the request for which CHECK issued was 

MNTACQ or ACQRANGE to issue a WAIT for lists 
of ECBs, IDA019SM issues SVC 109 routing code 6, 
which calls IGX00006 and then IDA0192E to freemain 
the WAIT list and the ECBs. See OS/VS2 MVS Mass 
Storage System Extensions: Communicator (MSSC) for 
a description of IGX0006 and IDA0192E. 


IDAOI9R1I calls IDAO19R5 


The buffer control block (BUFC) chain for the I/O 
block (IOB) in error is searched for a BUFC with an 
error indicator. 


Error conditions are analyzed and an error message is 
built. 


IDAO19R1 calls IDAO19R5 (IDAEXITR) 
For processing if a SYNAD routine exists. 
IDAO19R1: RICHECK 


The check process is repeated for each RPL (if any) in 
the RPL-string associated with the RPL that the 
CHECK was originally issued against. 


The placeholder is released if necessary. 


The placeholder remains associated with the current 
request-string unless the processing is direct. For direct 
processing, the next request must be repositioned to an 
address in the data set. For sequential or 
skip-sequential processing, the positioning information 
established by a prior request is used by the succeeding 
request. 
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Diagram BM. VERIFY Processing 


BB2 
5 


User’s Virtual Storage 


AMB 


User’s Virtual Storage 


eae ee ee 
——-2> 1. When the data set is key sequenced and the 
se recovery option (SPEED=OFF) is specified, GZ oo 
y, perform the following: Z lL 
/ 4) ee, 
/ y 
/ a | 
AMDSB 2 / 
a ao 3 On surfer CIDF 
Data Set 4 @ Search the data space associated with each index aes 
TIPE and data ARDB for a software end-of-file marker pos) 
ers ees in order to establish a valid high-used RBA in Be 
each ARDB. rae = 
_— 


ares 
a High-Used @ Search the index to establish the RBA of the 
RBA data control interval containing the highest key 
= { aeenewncren value in each data ARDB’s space. 
—= 


. When the data set is key sequenced and the 
nonrecovery option (SPEED=ON) is specified, 
perform the processing described for step 1 except 
that a high-used RBA cannot be established for 
the data ARDB(s). 


3. When the data set is entry sequenced, establish a 
high-used RBA for the data ARDB, as described in 
step 1, only if recovery (SPEED=OFF) is specified. 


. Return to caller. 
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Notes for Diagram BW 


1 IDA019R1: TERMRPL 
IDAO19R1 (TERMRPL) calls IDA019R1 (FINDOPLH) 


The placeholder (PLH) for the request string 
associated with the TERMRPL request is located by 
searching the placeholder list for a placeholder that 
points to the RPL identified by the TERMRPL. 


IDA019R1 (TERMRPL) calls IDA019SN 
2 IDAOI9SN 


Validity checks the data set attributes, RPL options, 
and processing conditions before performing the 
TERMRPL request. 


Releases all owned VSAM resources that are 
commonly shared by other requests. 


IDAO19SN calls IDAO19RZ (IDAFREEB) 


If the data set is a KSDS, IDAO19SN calls IDA0N19RZ 
(IDAFREEB). IDAFREEB frees the index buffer(s) 
that belong to the placeholder. 


IDAO19SN calls IDA019RZ (IDASBF) 


Excess data buffers are released from the placeholder 
for reuse. 


IDAO19SN calls IDAO19SE (IDARSTRT) 


An attempt is made to restart all deferred synchronous 
requests that are not in the same address space as the 
RPL identified by TERMRPL. 


If a deferred request that needs restarting is 
asynchronous, an error code will be returned to the 
user indicating TERMRPL cannot restart an 
asynchronous request. 


IDA019SN 


The placeholder is disconnected and any positioning 
information associated with this RPL is lost. 


3 IDA019R1: TERMRPL 


Return to the caller with completion code set in 
Register 15 and RPLFDBK. 
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Diagram BX1. CNVTAD: Converting Key/RRN/RBA to Volume Serial and RBA 


User’s Virtual Storage 


IDACNVPL 


. Validate the request options and the —_ 


. Convert the list (keys/RRNs/RBAs) to the 


. Set return code in register 15, make RPL 


User’s Virtual Storage 


ces, 


parameter list. IDACNVPL 


corresponding RBAs and volume serials. IDACNVPL 


inactive, and return. 
Register 15 


| 
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Notes for Diagram BX1 
1 IDAOI19RI calls IDA019SG 


€l'pLI UonevisdC jo poyep 


If the request is CNVTAD, call IDA019SG. 
IDA019SG calls IDA0O19RB, IGX00006 


Each IDACNVPL argument is converted to an RBA 
value. 


¢ For ESDS, the RBA is validity checked. 
e For RRDS, the RBA is calculated from the RRN. 


¢ For KSDS, an index search parameter list 
(IDAIXSPL) is built, and IDA019RB is called to 
search the index. 


A volume serial is obtained for each RBA by calling 
IGX00006, which issues SVC 26 (CATLG macro) to 
‘locate’ the volume serial. See OS/VS2 MVS Mass 
Storage Systern Extensions: Communicator (MSSC), 
LY35-0038, for a description of IGX00006. 
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Diagram BX2. MNTACQ: Mounting a Volume and Staging VSAM Records onto It 


User’s Virtual Storage 1. Validate the request options and the 
parameter list. SS 


IDAMNTPL 


2. The volume is mounted and the data 
cylinders corresponding to the RBAs 
are acquired. 


3. A return code is set in register 15, and the 
RPL made inactive. 


User’s Virtual Storage 


RPL 


“~ IDAMNTPL 
_~ ( 


S 


IDAMNTPL 


Staging Volume 


Register 15 


| 
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Notes for Diagram BX2 
1 IDAOI9RI calls IDAO19SL 
If the request is MNTACQ, IDA019SL is called. 
2 IDAOI19SL calls IDAEOVIF 
IDAEOVIF is called to mount the volume. 
IDAO019SL calls IDAMSSIF 
IDAMSSIF is called to issue SVC 109 route code 6 to 


acquire the data cylinders corresponding to the RBAs. 
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Diagram BX3. ACQRANGE: Staging a Range of Data from a VSAM Data Set. 


User’s Virtual Storage 


User’s Virtual Storage 
Validate the request options and the 


pot 
. 


RPL parameter list. RPL 
2. Validates argument pairs.§ ~~w___ . 
IDAACQPL ——— | onan 
RBAPL 


3. Builds RBA pairs lists, RBAPL. PZZZZZZZZZZZZALL DD 
4. Data cylinders corresponding to the starting, a | 
intermediate, and ending arguments are 


acquired. 


5. Returns to caller with completion code in 


Register 15. een Register 15 
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Notes for Diagram BX3 


1 


2 
3 


IDA019R1 calls IDA019SH 

If the request is ACQRANGE, IDA019SH is called. 

IDA019SH calls KSDSPROC or BLDRBAPL. 

« If it isa KSDS, IDA019SH calls KSDSPROC. 
KSDSPROC) calls IDA019RB 


The starting key index record is retrieved. If it is an 
IMBED data set, KSDSPROC calls IMBEDDS to 
retrieve the ending key; otherwise, NONIMBED is 
called. The RBA pair is built. 


e If it is an RRDS or ESDS, IDA019SH calls 
BLDRBAPL. 


BLDRBAPL converts RRNs to RBAs and builds the 
RBA pair list for RRDSs and ESDSs. 


4 IDAO19SH calls IDAMSSIF 


IDAMSSIF is called to issue SVC 109 route code 6 to 


acquire the data cylinders corresponding to the RBAs. 
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Diagram CA. GENCB: Build a New Control Block 


Ri Argument Control Entry 


Parameter 
List 


Parameter List 


tHeader ACE 
tElement ACE 


9 


tElement ACE 


User’s Program 
Issued GENCB 


— 1. Did the user request an ACB, RPL, or EXLST? 
Yes. No 
> Return to the user on ervor. 


‘a 


“~ 2. Determine the amount of virtual storage needed to 
satisfy the user’s request. 


; Length of User Area 


“A 3. Did the user supply an area to build the controi 
block in? 


Nit 
\ 


4. Obtain virtual storage for the control block. 


Element 


tElement ACE 


Keyword 
Type Code 


, 
ie =: 
NN 


5. Is the user’s area large enough? 


Yes 
‘&® Return to the caller on error. 


Element Argument Control Entry (ACE) Processing 
N Do steps 7 through 


12 to process each element ACE: 


7. Locate the ACE’s keyword-entry in KEYWDTAB 
8. Determine the entry type and process it as follows: 


Bitstring-type entry: 


9. Validate the bits in the string and place them 
in the block. Reset the default bits if necessary. 


Normal-type entry in an EXLST control block: 


10. Move the exit-routine address from the element 
ACE into the EXLST control block. 


11. Set the exit attribute flags. 
Normal-type entry in an ACB or RPL control block: 


13. Return to the user’s program. 


12. Move the user-supplied information from the 
element ACE into the control block. 


6. Initialize the control block with its default values. »ppp—a@weeeeee ee 


a7. 


Area of Virtual 
Storage for the 
‘Control Block and Copies 
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Record-Management Compendiums (Including End of Volume) 


GET (Entry-Sequenced or Key-Sequenced Data Set 


Vigure 2] 
GET: Sequential 
Processing 


Ligure 20 
GET: Direct and 
Skip Sequential 


Figure 22 
Obtain the Control Interval 
Containing a Specified Record 
and Establish the Position of 
the Reeord in the Control 
Interval 


PUT/ERASE (Entry-Sequenced or Key-Sequenced Data Set) 


ligure 24 
PUT 


Processing 


Ligure 25 
Update/Erase 


Processing 


Create Time 


igure 26 
Obtain the Next 
Control 

Interval 


igure 29 Figures 30 and 31 

Create Time Create-Time Sequence- Figure 28 
Sequence-set Set Record Processing: Split a 
Record Write the Record Control 
Processing: (End of Control Area 
Build an Entry Area) 


Path Processing 


Figure 36 


Establish Positioning 


by Way of the 


Index and Gain Access 
to the Base Cluster 


CNVTAD (KSDS) 


Figure 41 


CNVTA 
Processing 


Upgrade Processing 


Figure 37 
Upgrade the 
Alternate 


MNTACQ 


Figure 42 Figure 43 


D 


MNTACQ 
Processing 


Processing 


Figure 19. Record-Management Program Organization Contents 


Buffer Management 


Alternate Indexes 
in the Upgrade Set 


ACQRANGE (KSDS) CHECK 


ACQRANGE 


GET (Relative Record Data Set) TERMRPL 


Figure 23 Figure 39.1 
GET TERMRPL 
Processing 


Processing 


PUT/ERASE (Relative Record Data Set) 


Figure 35 
PUT/ERASE 


Processing 


Non-Create Time 


Figure 27 
Split a Control 
Interval 


Figure 33 and 34 UIBUEE 22 
Non-Create-Time 
Update the 
SequenceSet 
Index : 
Processing 


End of Volume 


Figure 38 
Regulate the 
Ownership and the 
Contents of the 
1/O Buffers 


Figure 39 
VSAM End 


of Volume 


ENDREQ 


Figure 45 
ENDREQ 
Processing 


Figure 44 


CHECK 
Processing 


Program Organization 219 


GET 
BALR R14, R15 


1 IDAOI9R1 


RO 2 IDAO19R4 
Request 3 IDAOIORA 
Type (See Figure 22) 


IDAOI9R4 
DATARTV 


Spanned Record 
§ IDAOIORT 
IDADARTV 


6 IDAOI9RZ 
IDAFREEB 


7 IDAOIORZ 
IDAGNXT 


Direct GET 


8 IDAOI9R4 
RLSEBUFS 


Return 


Address 


9 IDAOIYRZ 
IDAWRBFR 


10 IDAM1I9R3 
(See Figure 40) 


11 IDAOIIRZ 
IDAFREEB 


Return 
to 
Caller 


12 IDAOI9RZ 
IDAFREEFB 


13 IDAOI9RP 
IDATJXIT 


Figure 20. GET: Direct and Skip Sequential Processing (ESDS, KSDS) 


220 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Notes for Figure 39.1 


1 
2 


IDAO19R1 receives control from the TERMRPL macro. 


IDAOI9SN releases all commonly shared VSAM resources 
owned by the terminated RPL. 


IDAFREEB frees the index buffer (if the RPL is for a 
KSDS). 


IDASBF subtracts excess data buffers. 


IDARSTRT sttempts to restart all deferred synchronous 
requests not in the terminated address space. 


IDAOI19SN disconnects the PLH. 


IDAOI19R1 sets a condition code in register 15 and returns 
to caller. 
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1 IDAOI9RI 


2 IDAO19SG 


IDAWAIT 


3 


4 IDAOI9RB 


6 IDAFREEB 


8 IGX00006 


oe mel 
cae 


9 SVC 26 


Figure 39.2 CNVTAD Processing—Converts Key/RBA/RRN to Volume Serial and RBA 


266.2 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Notes for Figure 39.2 


1 


9 


When the CNVTAD macro is invoked, IDA019R1 is 
called to validate request options and parameter list. 


IDAOQ19R1 calls IDA019SG to convert the parameter list 
(IDACNVPL) arguments to RBAs and volume serials. 


IDA019SG WAITs for previous I/O to be completed. 
IDAO19RB is called for index search on keyed requests. 


The index record is searched to obtain an RBA for the 
BASE DATA RECORD. 


IDA019SG frees the buffer IDAO19RB gotten for the 
index search. 


For an ESDS, the RBA is returned; for an RRDS, the 
RBA is calculated. 


IG X00006 (SVC109) is called to obtain volume serials for 
each RBA. 


IGX00006 issues SVC 26 to ‘LOCATE’ the volume serials. 


10 IDAO019SG returns to IDAO19R1. 
11 IDAO19R1 returns to the user. 
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1 IDAOI9RI 


2 IDAOL9SH 


3 IDAOIORZ 
IDAWAIT 

4 IDAOI9RB 

5 IDAOI9RC 

6 IDAOI9RZ 
IDAGRB 

"7 IDAOIORZ 

IDAFREEB 

8 IDAOI9SL 

IDAMSSIF 


Figure 39.3 ACQRANGE Processing—Stages a Range of Data From a VSAM Data Set 


266.4 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Notes for Figure 39.3 


1 


on A KT ef 


When the ACQRANGE macro is invoked, IDA019R1 is 
called to validate request options and parameter list. 


IDAGI19R1 calls IDA019SH to build an RBA pairs list 
(IDARBAPL) consisting of keys/RBAs/RRNs describing 
ranges of data. 


IDA019RZ is called to WAIT for previous I/O 
completion. 


IDAO19RB is called to retrieve the starting key. 
IDAO019RC is called to retrieve the ending key. 
IDAO19RZ is called to get next index record, if necessary. 
IDA019RZ is called to free the buffers. 


IDAMSSIF is called to issue SVC 109 routing code 6 to 
acquire the data cylinders corresponding to the pairs of 
RBAs. 


When IDAO19SH regains control after the acquire, 
IDAO019SH returns the IDAACQPL, ECB WAIT list 
pointer, RPERREG, and RPLERRCD to IDAOI9R1. 


10 IDA019R1 WAITs or returns to user. 
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IDAOI9R1 


| 


2 


IDAOI9SL 


3 


IDAO19SE 
IDAEOVIF 
SVCS55$ 


5 IDAOI9SE 
IDADRQ 


6 IGX00006 


7 


IDAO192E 


8 IDAO19SK 


Figure 39.4 MNTACQ Processing—Mounts a Volume and Stages VSAM Records into It 
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Notes for Figure 39.4 


c 1 When the MNTACQ macro is invoked, IDAO19R1 is 
( called to validate request options and parameter list. 


2 IDAOI19RI1 calls IDAO19SL to mount the volume indicated 
by the parameter list. 


IDAO19SL calls IDAEOVIF to mount the volumes. 


4 IDAOI9SL calls IDAMSSIF to issue SVC 109 to acquire 
the data cylinders corresponding to the pairs of RBAs. 


IDAMSSIF locks the AMBXs to prevent EOV from 
running during the acquire. 


5 IDAO0192E is called to WAIT for previous I/O 
completion. 


6 IGX00006 (SVC 109 routing code 6) is called and retrieves 
the volume serial numbers of the volumes specified by the 
RBA pairs. 


7 IGX00006 calls IDA0192E to acquire the data cylinders by 
converting RBAs or RBA pairs to cylinder extents and to 
build an acquire parameter list and ECB. 


8 IDA0192E calls IDA019SK to sort cylinder extents into 
ascending sequence. If it is not a virtual device, the WAIT 
list is posted with successful completion and return to 
caller. If it is a virtual device, SVC 126 is called for acquire 
with deferred response. 


9 IDA0192E returns and passes the ECB WAIT list to 
IDAO19SL. 


10 IDAO19SL returns to IDA019R1 to WAIT or return to 
user. See OS/VS2 MVS Mass Storage System Extensions: 
Communicator (MSCC), for a description of IHX00006, 
Ca IDA0192E, and IDAO19SK. 
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1 IDAOI9RI 
2 RICHKMSS 


3 IDAO19SM 


4 1IGxX00006 


§ IDAOI192E 


6 IDASBF 


7 IDAOQI9RS 
IDALOCEX 


8 IDAOIORE 
IDAEXITR 


| 


Figure 39.5 CHECK Proecssing —WAITs and POSTs ECBs 


266.8 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Notes for Figure 39.5 


1 


When the CHECK macro is invoked, IDA019R1 is 
called to validate request options and parameter list. 


If the previous request was CNVTAD, MNTACQ, and 
ACQRANGE, control passes to RICHKMSS; 


otherwise, continues a normal CHECK with RICHECK. 


RICHKMSS provides CHECK function and internal 
synchronization for requests which specify SYN. 


R1ICHKMSS calls IDA019SM to do WAIT processing. 
IDA019SM WAITs on ECBs if any are not posted 
complete, sets RPLERREG/RPLERRCD from the ECB 
completion code, and releases the ECBs and WAIT list. 


IDAOI19SM calls IGX00006 to free ECBs. 


IGX00006 calls IDA0192E to process FREEMAIN 
request. FREEMAIN is issued for groups of ECBs if all 
are posted complete. 


R1ICHKMSS provides R1ICHECK function for 
CNVTAD, MNTACQ, and ACQRANGE. It calls 
IDASBF to subtract excess buffers and IDALOCEX to 
find error exits and IDAEXITR to take the exit. 


IDAO19R1 returns to user. 


See OS/VS2 MVS MSS Storage System Extensions: 
Communicator (MSCC), for a description of IGX00006 
and IDA0192E. 
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1 IDAOI9RI 


2 IDAOI9RP 


3 IDAO19SM 


4 IGX00006 


5 IDAO192E 


oe 
ed 


Figure 39.6 ENDREQ Processing—WAITs, POSTs, Frees ECBs 


266.10 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Page of SY26-3825-1 
Added March 30, 1979 
By TNL SN26-0932 


Notes for Figure 39.6 


1 


When the ENDREQ macro is invoked, IDA019R1 is 
called to validate request options and parameter list. 


IDAO19R1 calls IDAO19RP, the ENDREQ processing 
module. 


If previous request was MNTACQ or ACQRANGE, 


IDAO19RP calls IDA019SM to WAIT for I/O completion. 


IDA019SM WAITs on the ECBs; if any are not posted, 


sets RPLERREG/RPLERRCD from the ECB post code. 


IDA019SM calls IGX00006 to free ECBs. 


IGY00006 calls IDA0192E to process FREEMAIN 
request. FREEMAIN is issued for groups of ECBs if all 
are posted complete. 


ENDREQ processing for buffer flushing and error exits 
continues on return to IDA0O19RP from IDA019SM. 


IDAOI19RP returns control to IDAO19R1. 


IDAO19RP returns control to user. See OS/VS2 MVS 
Mass Storage System Extensions: Communicator (MSSC), 
for a description of IGX00006 and IDA0192E. 
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I/O-Management Compendiums 


1 IDAMI9R3 


2 IGC121 


3 VS2 PGFIX Routine : 
4 VS2 PGFREE Routine 


5S VS2 IEASMFEX 


7 VS2 IECSCRI1 


8 VS2 Basic 1/O Supervisor 


9 VS2 I/O Supervisor 
Post Status Routine 
(See ligure 47) 


10 VS2 Recovery 
Termination Manager 


11 IDAL21F2 


12. VS2 Recovery 
Termination Manager 


13 IDAL21F1 


14 IDAOL9YSE 
IDADRQ 


15 IDAOL9SE 
IDAEOVIF 


16 VS2 Recovery 
Termination Manager 


17 IDAM19R3 
PIODFRR 


Figure 40. I/O Management: Translating Virtual Addresses to Real Addresses and Completing a Channel Program for I/O 


266.12 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Module Directory 

Module Descriptive 

Name Name 

IDAO19SF — Control-Area Split-Spanned Records 

| IDA019SG_ Convert Keys/RRNs to RBAs 

IDA019SH Acquire a Range of Keys/RBAs/RRNs 

IDAO019SK _ Sort Acquire List Extents 

IDAO19SL Mount Volume and Acquire 

IDAO19SM Check and ENDREQ Support for 
MNTACQ/ACQRANGE Request 

IDAO19SN_ = Terminate RPL 

IDAO19S1 Improved Control-Interval Processing Driver 

IDA019S3_ —s Improved Control-Interval Processing—I/O 
Management 

IDA019S6 —- Control Interval Rebuild 

IDA0192A VSAM Open String 

IDA0192B Opena Cluster 

IDA0192C = Catalog Interface 

IDA0192D = Stage/Destage (ACQUIRE/RELINQUISH) 

IDA0192E Stage by RBA or RBA Range (ACQUIRE) 

| IDA0192F Open Base Cluster, Path, and Upgrade 

Alternate Index 

IDA0192G __Data-Space Security Verification 

IDA0192I ISAM Interface: Open Processing 

IDA0192M _ Virtual-Storage Manager 

IDA0192P VSAM Open/Close/EOV: Problem 
Determination 

IDA0192S_ VSAM Open/Close/EOV: SMF Record Build 

IDA0192V_ = Volume Mount and Verify 

IDA0192W = Channel-Program-Area Build 

IDA0192Y String Build and Shared-Resource 
Processor 

IDA0192Z  Control-Block Build 

IDA019SA VSAM SNAP Format Routine 

IDA0200B_ _—— Close a Cluster 


External 
Procedure 
Names 


IDADRQ 


IDAEOVIF 


IDARSTRT 
IDAO19SF 
IDA019SG 
IDA019SH 
IDAO19SK 
IDAO19SL 
IDA019SM 


IDA019SN 
IDAO019S1 
IDA019S3 


IDA019S6 
IDA0192A 


IDA0192B 


IDA0192C 


IDA0192D 


IDA0192E 
IDA0192F 


IDA0192G 
IDA0192I1 
IDA0192M 
IDA0192P 


IDA0192S 
IDA0192V 
IDA0192W 


IDA0192Y 


IDA0192Z 
IDAOI9S5A 
IDA0200B 


Component 


RM 


RM 


RM 


O/C/EOV 


O 
II 
O/C/EOV 
O 


O 


O/C 


O/C/EOV 
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IDA0200S 
IDA0200T 


IDA0231B 
IDA0231T 
IDA0557A 
IDA121A2 
IDA121F2 
IDA121A3 
F3FRR 

IDA121F3 
IDA121A4 
IDA121F4 
IDA121A5 
IDA121A6 
JEFNB902 
IFG0192A 


IFGO192Y 
IGC121 
IDA121F1 
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Module Directory 
Module Descriptive 
Name Name 
IDA0200S ISAM Interface: Close Processing 
IDA0200T VSAM Close String 
IDA0231B Close (TYPE=T) a Cluster 
IDA0231T | VSAM Close (TYPE=T) String 
IDA0S5S7A = VSAM End of Volume 
IDA121A2 Actual Block Processor 
IDA121A3 Normal End Appendage 
IDA121A4 Abnormal End Appendage 
IDA121A5 Asynchronous Routine 
IDA121A6 Purge Routine 
IDA121CV Communication Vector Table (IEZABP) 
IEFVAMP ~ AMP Parameter Interpreter 
IFGO192A © VSAM Open/Close/EOV String Load 

(Interface between OS/VS and VSAM O/C/EOV) 

IFG0O192Y BLDVRP/DLVRP Load Routine 
IGC121 Supervisor-State I/O Driver 
IGX00006 VSAM MSS Support SVC 
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O/C/EOV 
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Method of 
Operation 
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10, 16 
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External Procedure Directory 


Procedure 
Name 


IDAWRBFR 


IDAWRTBF 


IDAXGPLH 
IDAOA05B 
IDAOCO5B 


IDAO0C06C 
IDAOI96C 
IDAO019C1 
IDAO19RA 


IDA019RB 


IDA019RC 


IDA019RD 


IDAO19RE 


IDAO19RF 


IDA019RG 


IDA019RH 


IDAO19RI 


IDAOI9RJ 


IDAO19RK 


IDAOI9RL 


IDA019RM 


IDAO19RN 
IDA019RO 
IDAO19RP 
IDAO19RQ 
IDAO19RR 


IDAO19RS 
IDAO19RT 


Module 
Name 


IDAO19RZ 


IDA019RZ 
IDA019RU 
IDAOA05B 
IDAOCO5B 


IDA0C06C 
IDAOI96C 
IDA019C1 
IDAOI9RA 


IDA019RB 


IDAO019RC 


IDA019RD 


IDAOI9RE 


IDA019RF 


IDA019RG 


IDA019RH 


IDAO19RI 


IDAO19RJ 


IDAO19RK 


IDAO019RL 


IDA019RM 


IDA019RN 
IDA019RO 
IDAO19RP 
IDA019RQ 
IDAO19RR 


IDA019RS 
IDA019RT 


Descriptive 
Name 


Buffer Management: Write the Buffer 


Write a Buffer 
Get a Placeholder 
Checkpoint/Restart: Restart 


Checkpoint/Restart: SSCR and Initial 
DEB Processing 


Checkpoint/Restart: Checkpoint 
Checkpoint/Restart: SSCR Build and Cleanup 
Control Block Manipulation 


Direct Record Locate 


Index Search 


Search Compressed Index Blo-k 


DD DUMMY Processing 


Control-Interval Split 


Control-Area Split 


Index Create 


Index Insert 


Index Upgrade 


Split Index Record 


Preformat 


Data Modify 


Data Insert 


Indexing Subroutines 

Verify 

ENDREQ and JRNAD 
Relative Record Subroutines 


Relative Record Driver 


Spanned Record Data Modify 
Spanned Record Data Insert 


Method of 
Operation 
Diagrams 

BE, BG?2, BH3, 
BH4, BHS, BH8, 
BH9, BK1, BK2, 


BN2, BN3, BOI, 
BO2 


BB1 
AJ, ALI, AL2 
AK 


Al, AJ 
AJ 
CA, CB1, CB2 


BC, BE, BH1, 
BJ 


BC, BH1, BH8, 
BJ, BM 


BC, BH1, BH2, 
BH6, BI, BJ, 
BM, BS4 


BH1, BH3, BH7 


BH1, BH2, BH3, 
BH4, BHS 


BG1, BG2, BG3, 
BG4, BGS, BK2 


BH3, BH6, BH7, 
BH8 


BH4, BHS, BH7, 
BH8, BH9 


BH4, BH7, BH8, 
BH9, BH10 


BG2, BH4, BH8, 
BH9, BK2, BN2, 
BOI 


BH2, BI 


BE, BF, BH1, 
BH2, BH3 


BM 
BK1, BK2 
BO1, BO2 


BC, BD, BJ, 
BO] 


BH2, BI 
BE, BF, BH1 


20, 24, 25, 
26, 27, 28, 
32, 35, 38 


20,21; 22, 
24 


22, 34 


22, 24, 25, 
32 


24, 25, 27, 
28, 32 


24, 25, 26, 
27, 33, 34 


26, 29, 30, 
31 


27,32; 33; 
34 


28, 33, 34 


34 


24, 26, 28, 
29 


24, 25 


24, 25, 26, 
27, 28, 40 


35 
23, 29455 


24, 25 
24 
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External Procedure Directory 


Procedure 
Name 


IDA01I9RU 


IDAO019RV 
IDA019RW 
IDAOI9RX 
IDAOI9RY 


IDA019RZ 


IDAO19R1 


IDA019R2 


IDA019R3 


IDAO19R4 


IDAO19RS5 


IDAO19R8 


IDAOI9SA 


IDA019SB 


IDAOI9SE 


IDAO19SF 
IDA019SG 
IDA019SH 
IDAO1I9SK 
IDAO019SL 
IDA019SM 


IDAO19SN 
IDAO019S1 


IDA019S3 


IDA019S6 
IDAO192A 


IDA0192B 


Module 
Name 


IDA019RU 


IDAO19RV 
IDAOI9SRW 
IDAO19RX 
IDAOI9RY 


IDA019RZ 


IDAO19R1 


IDAOI19R2 


IDAM19R3 


IDA019R4 


IDAO19R5 


IDAO19R8 


IDAO019SA 


IDA019SB 


IDAO19SE 


IDA019SF 
IDA019SG 
IDA019SH 
IDA019SK 
IDA019SL 
IDA019SM 


IDAO19SN 
IDA019S1 


IDA019S3 


IDA019S6 
IDA0192A 


IDA0192B 


Descriptive 
Name 


Alternate-Index Upgrade Driver 


Locate Previous Sequence-Set Record 
Buffer Management, Part 2 
Path Processing Driver 


Shared Resources Buffer Management 


Buffer Management Interface 


Record Management: Request Decode and 
Validate 


Buffer Management, Part 1 


I/O Management: Problem-State I/O Driver 


Keyed/Addressed Request Driver 


I/O Error Analyais 


Control-Interval Processing 


Control-Interval Initialization-Create 
Entry-Sequenced Data Set 


Dynamically Build Channel Program 
Area for Shared Resources 


I/O Error Service Routines 


Control-Area Split-Spanned Records 
Convert Keys/RRNs/RBAs to RBAs 
Acquire a Range of Keys/RBAs/RRNs 
Sort ACQUIRE LIST Extents 

Mount Volume and Acquire 


CHECK and ENDREQ Support for MNTACQ 
and ACQRANGE Request 


Terminate RPL 


Improved Control-Interval Processing 
Driver 


Improved Control-Interval Processing- 
I/O Management 


Control Interval Rebuild 
VSAM Open String 


Open a Cluster 
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Method of 
Operation 
Diagrams 
BC, BD, BE, 
BH1, BI, BR 


BQ 
BP1, BP2, BP3, 
BS1, BS2, DA1 


BC, BS1, BS2, 
BS4 


AD7, BB1, BK1, 
BK2, BL 


BS1, BS2, BS3, 
DAI 


BGI, BS1, BS2, 
BS3, BS4, DAI, 
DA2, DA3 


BC, BD, BE, 
BF, BH1, BH3, 
BQ, BR 


BB3, BK1, BL 


BM, BN1, BN2, 
BN3 


BE, BF, BGI, 
BG2, BG3, BK2 


BB3, BE, BO1, 

BPI, BP3, BS2, 

BV, DAI, DA2, 
DA4 


BH4 


BW 
BNI, BN3 


BN1, BN3 


BC,BD,BH321,22 


AC1, AC2, AC7, 
AG 


AC4, ALI 


38 


12, 14, 20, 
21, 23, 24, 
35, 36 


38 


20, 22, 38, 
40 


20, 21, 22, 
24, 25, 36, 
37 


38 


26, 29, 30 


25, 26, 28, 
29, 34, 35, 
38, 39, 39.1, 
40 


28 

39.2 

39.3 

39.4 

39.4 

39.5, 39.6 


39.1 


8, 18 


External Procedure Directory 

Procedure Module Descriptive 

Name Name Name 

IDA0192C IDA0192C VSAM Open/Close: Catalog InterfaceAC2, AC4, AD6, 


IDA0192D 


IDA0192E 
IDA0192F 


IDA0192G 
IDA0192I 
IDA0192M 
IDA0192P 


IDA0192S 


IDA0192V 
IDA0192W 
IDA0192Y 


IDA0192Z 
IDA0200B 


IDA0200S 
IDA0200T 


IDA0231B 
IDA0231T 
IDA0557A 
IDA121A2 
IDA121A3 
IDA121A4 
IDA121A5 
IDA121A6 
IDA121F1 

IDA121F2 
IDA121F3 

IDA121F4 
IEFNB902 
IFG0192A 


IFG0192Y 
IGC121 
IGX00006 


IDA0192D 


IDA0192E 
IDA0192F 


IDA0192G 
IDA0192I 
IDA0192M 
IDA0192P 


IDA0192S 


IDA0192V 
IDA0192W 
IDA0192Y 


IDA0192Z 
IDA0200B 


IDA0200S 
IDA0200T 


IDA0231B 
IDA0231T 
IDAO0557A 
IDA121A2 
IDA121A3 
IDA121A4 
IDA121A5 
IDA121A6 
IGC121 

IDA121A2 
IDA121A3 
IDA121A4 
IEFVAMP 
IFG0192A 


IFG0192Y 
IGC121 
IG X00006 


Stage/Destage (ACQUIRE/RELINQUISH) 


Stage by RBA or RBA Range (ACQUIRE) 


Open Base Cluster, Path, and Upgrade 
Alternate Index 


Data-Space Security Verification 

ISAM Interface: Open Processing 

Virtual Storage Manager 

VSAM Open/Close/EOV: Problem Determination 


VSAM Open/Close/EOV: SMF Record Build 


Volume Mount and Verify 
Channel-Program-Area Build 


String Build and Shared-Resource 
Processor 


Control Block Build 


Close a Cluster 


ISAM Interface: Close Processing 
VSAM Close String 


Close (TYPE=T) a Cluster 

VSAM Close (TYPE=T) String 

VSAM End of Volume 

I/O Management: Actual Block Processor 
I/O Management: Normal End Appendage 
I/O Management: Abnormal End appendage 
I/O Management: Asynchronous Routine 
I/O Management: Purge Routine 
Functional Recovery Routine 

Functional Recovery Routine 

Functional Recovery Routine 

Functional Recovery Routine 

AMP Parameter Interpreter 


VSAM Open/Close/EOV String Load 
(Interface between OS/VS and VSAM O/C/EOV) 


BLDVRP/DLVRP Load Routine 
I/O Management: Supervisor State I/O Driver 
VSAM MSS Support SVC 
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Method of Program 

Operati 0 izati 

Diagrams Figures 
5, 6, 8, 

AD7, AE2, ALI, 12, 14, 15, 

BT] 18, 39 

AD6, AE2, BT2 8, 12, 14, 
18, 39 

— 39.4 - 39.6 

AC3, AC4, ACS, 8, 18 

AC6 

AL2 15 

AC1, AC7 7 

— 8, 10, 16 

AD5, AD6, AE2, 8, 12, 14, 

AH3 18, 39 

AC7, AD6, AE2 8, 12, 14, 
39 

AC3, BT1 5, 8, 18, 39 

ACI, AC4 8, 10 

AC1, AC4, ACS, 8, 10, 12, 

ADS, AF1, AH3, 14, 16, 18 

AL1, AL2 

AC4, ALI 8, 18 

AD1, AD3, AD4, 12 

AD6 

AD1, AD7 11 

AD1, AD2, AD3 12 

AD4, ADS, AD7 

AEI1, AE2 14 

AE1, AE2 14 

BT1, BT2 — 

DA2, DA3, DA4 40 

DA4 4l 

DAS Al 

DA4, DAS 41 

DA2 40 

DA3 40 

DA4 41 

DAS 41 

AF 5, 7, 8, 
11, 12, 14 

_- 10, 16 

DAI, DA2, DA3 40 

— 39.2, 39.4 
39.5,:39.6 
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External Procedure Directory 

Procedure Module Descriptive 

Name Name Name 

IMDUSRF9 AMDUSRF9 IMDPRDMP Format Appendage 
PIODFRR IDAM19R3 Functional Recovery Routine 
Module Packaging 


Most VSAM modules reside in pageable virtual storage; some 


Method of 
Operation 
Diagrams 


DAI 


I/O-Management modules reside in the nucleus. The following table lists the 
VSAM load modules and transients that are resident in the SVCLIB or 
LPALIB library or in the nucleus. Those in the libraries are loaded into the 
pageable supervisor or link-pack area by nucleus initialization (NIP) at initial 
program load (IPL). Those in the nucleus are link-edited there when the 
system is generated. 


Name 


Description 


Record Management 


IDAO19L1 


IDA019L2 


IDAOI9RS 
IDA019RT 


Open/Close/End of Volume and Checkpoint/Restart 
Open/Close/End of Volume 


IDA0192A 


ISAM Interface 


IDAIIFBF 
IDAITPM1 
IDAITPM2 
IDAIIPM3 
IDAIISM1 


Main Record Management 


Improved Control-Interval 
Processing 


Spanned Record Data Modify 
Spanned Record Data Insert 


FREEDBUF 
QISAM Load 
QISAM Scan 
BISAM 
SYNAD 
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VSAM Modules 


IDAM19R3, IDA019RA, IDAO19RB, 
IDAO19RC, IDA019RD, IDAOI19RE, 
IDAO19RF, IDA019RG, IDA019RH, 
IDAO19RI, IDAO19RJ, IDAO19RK, 
IDA019RL, IDA019RM, IDAOI9RN, 
IDA019RO, IDA019RP, IDA019RQ, 
IDAO19RR, IDA019RU, IDAO19RV, 
IDA019RW, IDA019RX, IDAOI19RY, 
IDA019RZ, IDA019R1, IDA019R2, 
IDA019R4, IDA019R5, IDA019R8, 
IDA019SA, IDA019SB, IDA019SF, 
IDA019SG, IDA019SH, IDAO19SL, 
IDA019SM, IDA019SE, IDA019SE 


IDA019S1, IDA019S2, IDA019S6 


IDAO19RS 
IDA019RT 


IDACKRAI,IDAOA05B, IDAOCOS5B, 
IDAO0CO06C, IDAOI96C, IDA0192A, 
IDA0192B, IDA0192C, IDA0192D, 
IDA0192F, IDA0192G, IDA0192I, 
IDA0192M, IDA0192P, IDA0192S, 
IDA0192V, IDA0192W, IDA0192Y, 
IDA0192Z, IDA0200B, IDA0200S, 
IDA0200T, IDA0231B, IDA0231T, 


IDA0557A 


IDAITFBF 
IDAIITPM1 
IDAITPM2 
IDAITPM3 
IDAIISM1 


9 
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Name Description VSAM Modules 
I/O Management 
IDAM19R3 Problem-State I/O Driver IDAM19R3 (Packaged in Main Record 
Management IDA019L1) 
IDA019SB Dynamic Channel Program IDA019SB (Nucleus) 
Area Build for Shared Resources 
IDA121A2 Actual Block Processor IDA121A2 (Nucleus) 
IDA121A3 Normal End Appendage IDA121A3 (Nucleus) 
IDA121A4 Abnormal End Appendage IDA121A4 (Nucleus) 
IDA121A5 Asynchronous Routine IDA121A5 
IDA121A6 Purge Routine IDA121A6 (Nucleus) 
‘ IDA121CV Communication Vector Table IDA121CV (Nucleus) 
(IEZABP) 
, IGC121 Supervisor-State I/O Driver IGC121 (Nucleus) 
Control Block Manipulation 
IDA019C1 Control Block Manipulation IDAO19C1 
VSAM Transient Routine 
IFG0O192A VSAM Open/Close/End of IDAICIA1, IDAOCEAI1, IDAOCEA2, 
Volume Loader IDAOCEA4, IFG0192A 
Miscellaneous Routines 
AMDUSRF9IIMDPRDMP format appendage AMDUSRF9 
IDA0195A VSAM SNAP format routine IDA0195A 
IEFVAMP AMP parameter interpreter IEFVAMP 
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Control Block Subpool Assignment 


Control Block Formats 


Subpool 230 in the high end of the user’s private address space contains the 
DEBs, to be consistent with OS/VS I/O Support and Checkpoint/Restart. 
Subpool 245 in the system queue area (SQA, in global storage) contains the 
IOSBs and SRBs because I/O Supervisor, running in any user’s private 
address space, needs them in a place where it can always address them. 
Subpool 241 contains ECBs for deferred response posting by MSS 
ACQUIRE. Subpool 252 in the low end of the private area contains the I/O 
control blocks that must be protected from user alteration (including 
alteration by Record Management). The AMBXN is not in Subpool 252 
(which has storage protection key of 0) because it contains fields from the 
AMB and the IOMB that Record Management needs to update. The 
AMBXN is in Subpool 250, along with other unprotected control blocks. 


All control blocks for a catalog are kept in global storage, in either Subpools 
231 and 241 in the common service area (CSA) or Subpool 245 in SQA. 


‘“Virtual-Storage Management” in “Diagnostic Aids”’ indicates the subpools 
in which storage for particular control blocks is indicated. 


This section discusses VSAM control blocks and (except for those adequately 
covered in OS/VS2 Data Areas) gives their format. 


OS/VS2 VSAM Cross Reference (microfiche) has a “Symbol Where Used 
Report”’ that lists alphabetically all the symbols used in VSAM modules, in 
particular the labels of the control blocks discussed here. With each symbol 
are listed all the modules that use it, along with a code that tells how each 
symbol is used: 

defined 

read (that is, referenced without alteration) 

written (that is, altered) 

compared 


AsRD 


ABP—Actual Block Processor (I/O-Management Communication Vector Table) 


The ABP is a communication vector table that contains entry points for I/O 
Management modules located in the nucleus. It is link-edited in the nucleus as 
IDA121CV, along with the modules. 


The ABP is created by NIP and pointed to by the system CVT (CVTIOBP). 
Actual Block Processor (ABP)—Description and Format 


Bytes and 

Offset Bit Pattern Field Name Description 

0 (0) 1 ABPID Control block identifier, X‘C1’ 

1 (1) 1 ABPLEN Length of the ABP 

2 (2) 2 ABPBR14 Unconditional branch, register 14 

4 (4) 4 ABPSIOD Address of the Supervisor-State I/O Driver 
(IGC121) 

8 (8) 4 ABPABP Address of the Actual Block Processor 
routine (IDA121A2) 

12 (C) 4 ABPNE Address of the Normal End Appendage 
(IDA121A3) 

16 (10) 4 ABPAE Adddress of the Abnormal End Appendage 
(IDA121A4) 
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ACB—Access Method Control Block 


The VSAM ACB describes a VSAM cluster. It is built by the user’s program 
with the ACB or GENCB macro. Before the cluster is opened, the ACB can 
be modified by the user’s DD statements and by the MODCB macro. After 
the cluster is opened, the ACB is pointed to by the RPL (RPLDACB) that 
describes the user’s record processing request. 


Access Method Control Block (ACB)—Description and Format 


Bytes and 
Offset Bit Pattemm Field Name Description 
0 (0) 1 ACBID Control block identifier, X‘ AO’ 
1 (1) 1 ACBSTYP Subtype: 
X‘10’ = VSAM 
X‘20’ = VTAM 
2 (2) 2 ACBLENG Length of the ACB 
4 (4) 4 ACBAMBL Address of the AMBL 
ACBIXLST Address of the index list i 
ACBJWA 
ACBIBCT 
8 (8) 4 ACBINRTN Address of the VSAM Interface routine 
(IDA019R1) 
12 (C) 2 ACBMACRF MACRF flags: 
ACBMACRI MACRF flag byte 1: 
| eee ACBKEY The record is identified by a 
key—keyed processing 
Wve Beets ACBADR The record is identified by a RBA 
ACBADD (relative byte address) —addressed 
processing 
euler Zeek ACBCNV Control interval processing 
ACBBLK 
ree eee ACBSEQ Sequential processing 
noha ad ACBDIR Direct processing 
fon ACBIN Input (GET, READ) processing 
or ACBOUT Output (PUT, WRITE) processing 
ganas 1 ACBUBF User-supplied buffer space 
13 (D) ACBMACR2 MACRF flag byte 2: 
en een ACBSKP Skip sequential processing 
aaa Mics ACBLOGON VTAM LOGON indicator 
ee ACBRST Set data set to empty state 
1. ACBDSN Basic subtask shared control-block : 
connection on common DSNAMEs 
uaaiess 1 ACBAIX Object to be processed is the alternate index 
of the path specified in the given DDNAME 
©. 6, eee Reserved , 
14 (E) 1 ACBBSTNO Number of concurrent strings for 
alternate-index path 
15 (F) 1 ACBSTRNO Number of RPL strings 
16 (10) Z ACBBUFND Number of buffers requested for data 
18 (12) 2 ACBBUFNI Number of buffers requested for index 
20 (14) 4 ACBBUFPL Address of the buffer header (BUFC) 
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AMBL—Access Method Block List 


The AMBL describes a VSAM cluster and points to the cluster’s data set and 
index AMBs. When the cluster is opened, an AMBL is built to describe the 
cluster. If the cluster’s data set (and index) is shared with other users, AMBs 
already exist for the data set (and index). The existing AMB’s addresses are 
put into the AMBL. If the cluster is not shared, AMBs are built to describe 
the cluster’s data set and, if the cluster is key-sequenced, to describe the data 
set’s index. The AMBL is pointed to by the cluster’s ACB (ACBAMBL). 


Access Method Block List (AMBL)—Description and Format 


Offset 
0 (0) 


4 (4) 


8 (8) 


12 (C) 


13 (D) 
14 (D) 
16 (10) 
16 (10) 
16 (10) 
20 (14) 


23 (17) 


24 (18) 


28(1C) 


28(1C) 


29(1D) 


Bytes and 


Bit Pattern 


4 


wo bh © Cf NN — 


Field Name 
AMBLPCHN 


AMBLSCHN 


AMBLACB 


AMBLEFLG 


AMBLWAIT 
AMBLESET 


AMBLCOMP 


AMBLDDNM 
AMBLIDF 
AMBLCACB 
AMBLDCI 


AMBLQ 


AMBLDDC 
AMBLGSR 
AMBLLSR 
AMBLFSTP 


AMBLUBF 
AMBLKSDS 
AMBLESDS 
AMBLDFR 
AMBLXPT 
AMBLVC 


AMBLVRT 


AMBLENO 


Description 
Address of the primary AMBL in the AMBL 
chain 


Address of the secondary AMBL in the 
AMBL chain 


Address of the ACB associated with the 
AMBL 


End of Volume flags: 


End of volume is waiting 

End of Volume encountered an error and 
restored control blocks to their original 
condition 

Reserved 


End of Volume lock 

Reserved 

The ACB’s DDNAME field 
Cluster identifier 

Address of the ACB of the catalog 


Control-interval number of the catalog data 
record 


Qualifier: 


DD connect only 

Cluster opened for global shared resources 
Cluster opened for local shared resources 
Cluster opened for fast path (improved 
control-interval access) 

Cluster opened for user buffering 

Cluster opened as a key-sequenced data set 
Cluster opened as an entry-sequenced data 
set 

Cluster opened for deferred writes 


In a base AMBL, address of the path AMBL; 
in a path AMBL, address of the base AMBL 


Identifies the entry in the valid-AMBL table 
that idnetifies this AMBL: 


Number of the valid-AMBL table in the 
chain of valid-AMBL tables 


Offset within the valid-AMBL table 
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Access Method Block List (AMBL)—Description and Format 


Offset 
30(1E) 


31(1F) 


32 (20) 
33 (21) 


34 (22) 
35 (23) 


36 (24) 


37 (25) 
38 (26) 
40 (28) 
41 (29) 
42 (2A) 


52 (34) 


Bytes and 
Bit Pattern 


1 


Ce eS 


4 
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Field Name 


AMBLTYPE 


AMBLPATH 
AMBLUPGR 
AMBLAIX 
AMBLBASE 
AMBLFIX 


AMBLQ2 
AMBLCBIC 


AMBLID 
AMBLSHAR 


AMBLPRIM 
AMBLCATO 
AMBLWRIT 


AMBLLEN 
AMBLFLGI1 
AMBLFULL 


AMBLCINV 
AMBLUPD 
AMBLVVIC 


AMBLSDS 
AMBLSCRA 


AMBLUCRA 


AMBLCAT 


AMBLDUMY 


AMBLFLG2 


AMBLSTAG 
AMBLII 


AMBLNST 
AMBLNUM 


AMBLNIDS 
AMBLMIDS 


AMBLDTA 


Description 
Type of control block structure opened: 


Path 

Upgrade set 

Alternate index 

Base cluster 

Control blocks are fixed in real storage 
Reserved 


Qualified extension 

Cluster opened with control blocks in 
common storage area 

Reserved 


Control block identifier, X°50’ 
Sharing indicators: 


Identifies the primary AMBL 
The catalog is open 


The user intends to write or update records 


in the data set 
Reserved 


Length of the AMBL 
Flags: 


The user-supplied master password was 
verified 

The user-supplied control-interval 
password was verified 

The user-supplied update password was 
verified 


The AMBL is for the mass storage volume 


inventory (MSVI) data set 
The AMBL is for a system data set 


The AMBL is for a catalog recovery area in 


system storage 

The AMBL is for a catalog recovery 
area in user’s storage 

The AMBLACB field points to a catalog’s 


ACB 
A DD DUMMY statement was specified 


The combination of these bits indicates the 


type of data set: 
001 Catalog 
101 MSVI 
011 SCRA 
Flags: 


Cluster is staged 

This AMBL is for an ISAM interface 
structure 

Reserved 


Number of strings 
Number of AMB pointers in the AMBL 
Reserved 


Number of identifiers 


Five 2-byte fields, each containing a VSAM 


module’s identifier 


Address of the cluster’s data set AMB 
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Access Method Block List (AMBL)—Description and Format 
Bytes and 
Offset Bit Pattern Field Name Description 
56 (38) 4 AMBLIX Address of the cluster’s index AMB 
60 (3C) 4 AMBLBIB Address of the base information block 
64 (40) 4 AMBLCMB Address of the cluster management block 
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Index Modification Work Area (IMWA)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
a le IMWBSE Indicates the new index entry should be a 
section entry 
-X XXXX Reserved 
2 (2) 2 IMWLEN Length of IMWA in bytes 
4 (4) 4 IMWIXSP Address of index search parameter list 
8 (8) 32 IMWISWKA Index search parameter list (see LXSPL) 
40 (28) 4 IMWXKEYP Address of the next (higher-keyed) index 
entry 
44 (2C) IMWIKEYP Address of the new index entry’s key 
48 (30) 4 IMWXPTR Value of the index pointer field in the next 
(higher-keyed) index entry 
52 (34) 4 IMWIPTR Value to be inserted in new index entry's 
pointer field 
56 (38) 4 IMWLBUFC Address of a data BUFC for a data buffer 
containing the lowest key following a 
control-area split 
60 (3C) 4 IMWBUFP Address of the index record being processed 
64 (40) 1 IMWFGAIN Front key-compression adjustment to be 
added to IBFLPF field in next (higher-keyed) 
index entry 
65 (41) 1 IMWIEL Value of IBFLPL field—that is, compressed 
length of new index entry's key 
66 (42) 1 IMWSVIEL Save area for IBFLPL value 
67 (43) 1 Reserved 
68 (44) 2 IMWCIMVN Readjustment to number of control intervals 
in old control area following a control area 
split to enable an index record to be built for 
the new control area 
70 (46) 2 IMWNSOFF Offset to next section entry in index record 
72 (48) 4 Reserved 
76(4C) (keylength) IMWKEY1 Highest possible key for a mass 


insertion—that is, last key in a sequence of 
keys to be inserted which is less than an 
existing key; also, save area for current insert 
key under a no-fit condition 
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IOMB—I/O-Management Block 


The IOMB is used by I/O Management to control its processing of a request. 
It contains the addresses of other control blocks, flags used by I/O 

Management, and a 16-word register save area. The addresses of the first 
BUFC and CPA are inserted by I/O Management after it verifies the control 


blocks. 


The IOMB is pointed to by the PLH (PLHIOB). It points to the IOSB, which 
points to the SRB. These three control blocks take the place of the IOB, 
which is used by some other drivers of the I/O Supervisor. 


I/O Management Block (IOMB)—Description and Format 


Offset 
0 (0) 
4 (4) 
8 (8) 
12 (C) 
16 (10) 
20 (14) 
24 (18) 
28 1C) 


32 (20) 


36 (24) 
40 (28) 
40 (28) 
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Bytes and 
Bit Pattern 


4 


& ff fL£ Lh fF HL FL 


Field Name 
IOMBID 
IOMBUFC 
IOMCPA 
IOMPLH 
IOMAMB 
IOMIQE 
IOMECBPT 
IOMVSL 


IOMPGAD 


IOMIOSB 
IOMFLAGS 
IOMFL 


IOMAPEND 
IOMNE 
IOMAE 
IOMPURGE 
IOMCBERR 
IOMADERR 


IOMPGFIX 
IOMCSW 


IOMDDR 
IOMCPRB 


IOMEEXIT 
IOMIRBSW 


IOMSTIND 


IOMAMUSE 
IOMEOVW 
IOMEOVTS 
IOMEOVXC 
IOMLLOCK 


Description 

Control block identifier: ‘IOMB’ 
Address of the first BUFC 
Address of the first CPA 
Address of the PLH 

Address of the AMB 

Address of the IQE (interrupt queue element) 
Address of the ECB 


Address of the VSL (virtual subarea list, 
which is the same as the PFL, page fix list) 


Address of the caller to get control when I/O 
operation is complete (zero for Record 
Management—used for Auxiliary Storage 
Management) 


Address of the IOSB 
Flags: 
Flags reset after I/O completes: 


Byte 1: 

Appendage flags: 

Normal End Appendage completed 
Abnormal End Appendage completed 

A purge is in progress 

A control block wasn’t valid 

Virtual addresses in the VPL weren't 
successfully converted to real addresses for 
the IDAL 

Pages are fixed in real storage 

The address of the channel status word is 
incorrect 

Reserved 


Byte 2: 

Dynamic-device reconfiguration 
Problem state caller 

Reserved 

Channel end appendage exited 
Asynchronous processing scheduled 
Reserved 


Status indicators: 


The IOMB is in use 

End of Volume is waiting for an IOMB 
End of Volume has set the IOMLOCK field 
End-of-Volume indicator 

A local lock is held 
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1/O Management Block (IOMB)—Description and Format 


Offset 


Bytes and 
Bit Pattern 


Field Name 


IOMSLOC 
IOMSRBM 


IOMSR 


Description 


SALLOC is held 

The user is processing with SRB (event) 
dispatching 

Suspend/Resume indicator 
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VGTT—VSAM Global Termination Table 


The VGTT identifies global virtual storage that may need to be specially freed 
if an error prevents it from being freed normally. There are various types of 
VGTTs for: 


Keeping track of an address space’s use of a global VSAM resource pool 
(for processing with global shared resources) 


Keeping track of certain control blocks (sets of IOSB, SRB, and PFL) that 
are kept in global storage for processing with local shared resources (the 
normal pointers to these control blocks are in unprotected local 
storage—the VGTT is in global storage, adjacent to them) 


Keeping track of control blocks during the opening of a catalog, a catalog 
recovery area, or the mass storage volume inventory data set (all of whose 
control blocks are kept in global storage 


Keeping track of certain control blocks (sets of IOSB, SRB, and PFL) that 
are kept in global storage for processing a user data set and all related data 
sets (such as alternate indexes) 


Keeping track of control blocks (ECBs and WAITLIST if also GSR) that 
are kept in global storage for stage by key range processing. 


The VGTT is pointed to by the ASCB (address space control block). It is 
chained to the next VGTT for the address space. 


VSAM Global Termination Table (VGTT)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 4 VGTTID Control block identifier: “VGTT’ 
4 (4) l VGTTTYPE VGTT type indicator: 
| Peres VGTTSDS  VGTT is for system data set 
wl... WGTTGSR VGTT is for processing with global shared 
resources—VGTTVUSE is used 
wl... WGTTLSR  VGTT is for processing with local shared resources 
1... WGTTCTLG VGTT is for opening a catalog, a catalog recovery 


area, or the mass storage volume inventory data set 
... 1... WGTTOPEN VGTT is for processing a user’s data set without 
shared resources 


..1... WGTTCBIC Opened with control blocks in common storage area 


beats XX Reserved 

5 (5) 1 Reserved 

6 (6) 1 VGTTGSRK GSR key type, if VGTTGSR is on 

7 (7) 1 VGTTSP Subpool number of the VGTT and of the global 
storage it protects 

8 (8) 4 VGTTSIZE Length of the VGTT 

12 (C) 4 VGTTNEXT Address of the next VGTT (zero for the last VGTT in 
the chain) 

16 (10) 4 VGTTBIB Address of the base information block for the user’s 
data set and all related data sets (such as alternate 
indexes) 

20 (14) 4 VGTTVUSE Fora VGITT for global shared resources, the use count 


that was contributed by the processing of the user’s 
data set and all related data sets. 


Data Areas 361 


Page of SY26-3825-1 
As Updated March 30, 1979 


By TNL SN26-0932 

VSAM Global Termination Table (VGTT)—Description and Format 

Bytes and 
Offset Bit Pattem Field Name Description 
24 (18) 4 VGTTPSB _ Address of the protected sphere block (which contains 
HEBs for use by Virtual-Storage Management) 
28(1C) 4 Reserved 
32 (20) VL VGTTCORE For a VGTT for local shared resources, the 
virtual-storage area the VGTT protects 

VIOT—Valid-IOMB Table 

The VIOT contains the address of each valid IOMB within a VSAM resource 

pool (for processing with shared resources). It is pointed to by the VSRT 

(VSRTVIOT) and by each AMB associated with the resource pool. ‘ 

Valid-IOMB Table (VIOT)—Description and Format 

Bytes and 

Offset Bit Pattern Field Name Description 

0(0) 4 VIOHDR Header 

0(0) | VIOID Control block identifier, X°16’ 

1(1) 1 Reserved 

2(2) 2 VIOLEN Length of the valid-IOMB table 

4(4) 4xn  VIOPTR Address of a valid IOMB; this field is repeated n times 
VMT—Volume Mount Table 


The VMT identifies and describes volumes that are mounted for a base 
cluster and all clusters associated with it for processing. There is a VMT for 
each device type. The first VMT is pointed to by the BIB (BIBVMT). 


Volume Mount Table (VMT)—Description and Format 


Bytes and 
Offset Bit Pattern Field Name Description 
0 (0) 4 VMTHDR Header: 
0 (0) 1 VMTID Control block identifier, X‘12’ 
1 (1) | Reserved 
2 (2) Z VMTLEN Length of the VMT 
4 (4) 4 VMTNXT Address of the next VMT 
8 (8) 2 VMTNOVOL Number of volume entries ( 7) in the VMT 
10 (A) 3 * Reserved 
13 (D) 3 VMTDEV Device information: 
13 (D) 1 VMTDVOPT Device options 
14 (E) Z VMTDVTYP Device class and type 
16(10)16 xn VMTVOL Volume entry for a volume to be mounted: 
16(10) 4 VMTUSECT Use count 
20 (14) 1 VMTVFLGI1_ Volume flags: 
| eee VMTOPEN The volume is being processed by Open 
»XXX XXXX Reserved 
21 (15) | Reserved 
22(16) 6 VMTVLSER _ The volume’s serial number 
28(1C) 4 VMTUCB Address of the UCB for the volume 
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Function 
Code 


Open 


Module that 
Detected 
Error 


IDA0192C 
IDA0192C 


IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192C 
IDA0192V 
IDA0192V 
IDA0192V 
IDA0192V 
IDA0192S 
IDA0192S 
IDA0192D 
IDA0192D 
IDA0192D 
IDA0192D 
IDA0192Z 
IDA0192Z 
IDA0192Z 
IDA0192Z 
IDA0192Y 
IDA0192B 
IDA0192B 
IDA0192B 
IDA0192B 
IDA0192W 
IDA0192W 
IFG0193A 
IDA0192A 
IDA0192A 
IDA0192F 
IDA0192B 
IDA0192F 
IDA0192A 


Operation Being Performed When 
Error Was Detected 


Initialize for catalog interface processing. 


Determine which data sets are associated with data-set name 
on DD statement, determine catalog, and check password. 


Determine data-set attributes. 

Get volume information. 

Update “‘open” indicator in catalog. 

Update catalog when data set is being closed. 
Retrieve volume timestamp. 
Record-Management catalog update. 

Update preformat indicator in catalog. 
Retrieve 44-byte cluster name. 

Retrieve 44-byte component name. 

Initialize for mounting and verify volume. 
Check volume timestamp. 

Handle messages. 

Mount volume. 

Initialize for SMF processing. 

Build SMF record. 

Initialize for staging. 

Build UCB list. 

Build list for ACQUIRE/RELINQUISH (stage/destage). 
Issue ACQUIRE or RELINQUISH. 
Initialize for building control blocks. 
Determine number of buffers needed. 

Build buffers. 

Build control blocks. 

Build string blocks. 

Module initialization. 

Locate data-set attributes and check them for validity. 
Volume processing. 

Preformat extent. 

Initialize for building channel program. 
Build channel program area. 

Check return codes from IFG0191X or IFGO191Y. 
Initialize for VSAM Open processing. 

Verify ACB. 

Fix control blocks in real storage. 

Allow subtasks to share data set. 

Mount and verify volumes. 


Determine whether to connect base cluster to an existing 
structure or generate a new structure. 
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Module that 
Function Detected Operation Being Performed When 
Code Error Error Was Detected 
88 IDA0192F Open base cluster. 
89 IDA0192F Open alternate index in upgrade set. 
90 IDA0192F Open alternate index in path. 
93 IDA0192A Build adummy DEB. 
95 IDA0192A Terminate VSAM Open processing. 
96 IDA0192A _ Clean up after an error in Open processing. 
99 IFG0192B ‘Error processing for ACB being processed on a system not 
generated for VSAM. 
Close 
100 IFGO200V Read JFCB. ; 
101 IDA0200T Initialize for VSAM Close processing. 
102 IDA0200T Check validity of AMBL and DEB. 
103 IDA0200T Complete deferred write requests. 
104 IDA0200T Close path. 
105 IDA0200T Close base cluster. 
106 IDA0200T Close sphere (close upgrade alternate indexes and free 
storage). 
107 IDA0200T Close upgrade set. 
108 IDA0200T Process volume mount table. 
109 IDA0200T Close dummy data set. 
110 IDA0200B Module initialization. 
111 IDA0200B_ Check validity of AMBLs and DEBs. 
112 IDA0200B SMF processing. 
113 IDA0200B_ Update statistics and RBA information in the catalog. 
114 IDA0200B ‘Free storage for control blocks. 
115 IDA0200B_ Write a buffer. 
148 IDA0200T Force deletion of VSAM global resource pool. 
149 IDAOCEA2 Force deletion of VSAM global resource pool. 
150 IGC0002C Read JFCB. 
151 IDA0231T Initialize for VSAM Close (TYPE=T) processing. 
152 IDA0231T Check validity of AMBL and DEB. | 
153 IDA0231T Complete deferred write requests. 
154 IDA0231T Close (TYPE=T) path. ° 
155 IDA0231T Close (TYPE=T) base cluster. 
156 IDA0231T Close (TYPE=T) upgrade set. 
157 IDA0231B Module initialization. 
158 IDA0231B Check validity of AMBLs and DEBs. 
159 IDA0231B Update statistics and RBA information. 
160 IDA0231B SMF processing. 
161 IDA0231B_ Write a buffer. 
End of Volume 
200 IFGO551F Read JFCB. 
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Macros 


Mapping Macros 


Function 
Code 
201 
202 
203 
204 
205 
206 
207 
208 
209 
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Module that 
Detected Operation Being Performed When 
Error Error Was Detected 


IDA0557A_ Initialize for VSAM End-of-Volume processing. 
IDA0557A_ Locate and mount volume. 

IDA0557A_ Allocate space. 

IDA0557A Switch volumes. 

IDA0557A_ Build control blocks. 

IDA0557A Update SMF record. 

IDA0557A_ Preformat extent. 

IDA0557A Record Management, catalog update. 
IDA0557A_ Reset control blocks. 


The following tables list VSAM and OS/VS macros and explain what they 
do. The macros are divided into those that define control blocks and data 
areas (mapping macros) and those that issue executable code (action macros). 


OS/VS2 VSAM Cross Reference (microfiche) has a table (“Macro Where 
Used Report’’) of all the macros issued by VSAM with a listing of the 
modules (and other macros) that issue them. 


The following table lists macros that define the format of control blocks and 
data areas used by VSAM modules. 


Macros That Define Data Areas 

Macro Description 

ACB Builds an access-method control block (ACB) at assembly time 
CVT Maps the communication vector table (CVT) 

ECB Maps the event control block 

IDAACQPL = Maps the acquire range parameter list (ACQPL) 

IDAAIR Maps the alternate-index record 

IDAAMB Maps the access method block (AMB) 

IDAAMBL Maps the access method block list (AMBL) 

IDAAMBXN _ Maps the access method block extension (AMBXN) 
IDAAMDSB_ Maps the access method data set statistics control block (AMDSB) 
IDAARDB Maps the address range definition block (ARDB) 

IDAARWA Maps a recovery work area for the Restart modules 

IDABIB Maps the base information block (BIB) 

IDABFR Maps the buffer control set 

IDABLPRM _ Maps the resource pool parameter list (BLPRM) 

IDABSPH Maps the buffer subpool header (BSPH) for shared resources 
IDABUFC Maps the buffer control block (BUFC) 

IDACBTAB Maps the tables used by the Control Block Manipulation routine 
IDACIDF Maps the control-interval descriptor field (CIDF) 
IDACLWRK_ Maps the close work area 
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Macros That Define Data Areas (continued) 


Macro Description 

IDACMB Maps the cluster management block (CMB) 

IDACNVPL Maps the convert keys/RRNs/RBAs parameter list (CNVPL) 
IDACPA Maps the channel program area (CPA) 

IDACSL Maps the core save list (CSL) 


IDACTREC Maps the work area built when the VS2 Catalog-Management routines use 
Open, Close, or End of Volume 


IDADIWA Maps the data insert work area (DIWA) 
IDADSECT Maps miscellaneous data areas for Checkpoint/Restart 


IDADSL Maps the DEB save list (DSL) 

IDAEDB Maps the extent definition block (EDB) 

IDAELEM Maps the Control Block Manipulation routine’s element argument control 
entry 

IDAEQUS Defines the equates for the ISAM Interface: SY NAD—Message-Build 
routine 


IDAERMSG _ Maps the ISAM Interface: SYNAD Message format 
IDAERRCD Lists the VSAM Open and Close ACB Error Codes 
IDAESL Maps the enqueue save list (ESL) 


IDAFOREC Maps the work area for VSAM Open, Close, and End of Volume (the 
work area is called “FORCORE” in program comments) 


IDAFOREC issues IDAPDPRM, IEFJFCBN, and IEFJFCBX. 
IDAGENC Maps the GENCB header argument control entry 
IDAHEB Maps the header element block (HEB) 
IDAICWA Maps the index create work area (ICWA) 
IDAIDXCB Lists the VSAM control-block-identifier codes 
IDAIICB Maps the ISAM-Interface control block (IICB) 
IDAITIREG Defines the ISAM-Interface register usage 
IDAIIREG issues IDAIICB, IDARPLE, IFGRPL, IHADCB, and 


IHADCBDF. 
IDAIMWA Maps the index modification work area (IMWA) 
IDAIOB Maps the VSAM IOB extension 


IDAIOMB Maps the I/O-Management control block (IOMB) 


IDAIOSCN Maps the VSAM Open, Close, and End-of-Volume commonly-used 
declarations 


IDAIRD Defines the index record 

IDAIXSPL Maps the index search parameter list (IXSPL) 

IDALPMB Maps the logical-to-physical mapping block (LPMB) 

IDAMNTPL Maps the mount volume and acquire parameter list (MNTPL) 

IDAMODC Maps the MODCB header argument control entry 

IDAOPWRK_ Maps the ACB work area for Open (OPW or OPWRK) 

IDAPDPRM Maps the VSAM Open, Close, and End-of-Volume problem determination 


parameter list 
IDAPLH Maps the placeholder (PLH) 
IDAPSL Maps the page save list (PSL) 


IDARBAPL Maps the RBA paris list (RBAPL) 
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Macros That Define Data Areas (continued) 


Macro 


IDARDF 
IDAREGS 
IDARMRCD 
IDARPLE 
IDARTMAC 
IDASHOW 
IDASSL 
IDATEST 
IDAUPT 
IDAVAT 
IDAVCRT 


IDAVGTT 
IDAVIOT 
IDAVMT 
IDAVSRT 
IDAVUCBL 


IDAVVOLL 


IDAWAX 
IDAWSHD 
IECDIOCM 
IECDIOSB 
IECDIPIB 
IECDSECS 
IECDSECT 
IECRRPL 
IECSDSL1 
IEESMCA 
IEEVCHWA 
IEEVRSWA 
IEFJFCBN 
IEFJFCBX 
IEFJMR 
IEFTCT 
IEFTIOT1 
IEFUCBOB 
IEZABP 


IEZCTGFL 
IEZCTGPL 
IEZDEB 


Description 

Maps the record definition field (RDF) 

Defines register usage for all Record-Management modules 
Lists the Record-Management return codes 

Maps the ISAM-Interface request parameter list extension (RPLE) 
Maps data structures for recovery routines 

Maps the SHOWCEB header argument control entry 

Maps the swap save list (SSL) 

Maps the TESTCB header argument control entry 

Maps the upgrade table (UPT) for upgrading alternate indexes 
Maps the valid-AMBL table (VAT) 


Maps the VSAM checkpoint/restart table (VCRT), the VSAM 
checkpoint/restart storage blocks (VCRCORE), and the HEB save area 
(VCRHEBSA). 


Maps the VSAM global termination table (VGTT) 
Maps the valid-IOMB table (VIOT) 

Maps the volume mount table (VMT) 

Maps the VSAM shared resource table (VSRT) 


Maps the VSAM Open and End of Volume: Volume Mount and Verify 
UCB list 


Maps the VSAM Open and End of Volume: Volume Mount and Verify 
volume serial number list 


Maps the work area for path processing (WAX) 

Maps the working storage header (WSHD) 

Maps the communication area of the VS2 I/O Supervisor 
Maps the I/O-Supervisor control block (IOSB) 

Maps the I/O Supervisor—Purge interface block (IPIB) 

Maps the DSECS 

Maps the common open/close work area 

Maps the common O/C/EOV Recovery Routine parameter list 
Maps the SDSL1 

Maps the SMCA 

Maps a work area that VS2 Checkpoint passes to VSAM Checkpoint 
Maps a work area that VS2 Restart passes to VSAM Restart 
Maps the job file control block (JFCB) 

Maps the job file control block (JFCB) 

Maps the JMR 

Maps the TCT 

Maps the task input/output table (TIOT) 

Maps the VS2 unit control block (UCB) 


Maps the ABP—I/O-Management communication vector table (module 
IDA121CV) 


Maps the VS2 catalog field parameter list (CTGFL) 
Maps the VS2 catalog parameter list (CTGPL) 
Maps the VS2 data extent block (DEB) 
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Action Macros 


Macros That Define Data Areas (continued) 


Macro 


IEZIOB 
IEZJSCB 
IFGACB 
IFGEXLST 
IFGRPL 


IGGCAXWA 


IHAASCB 
TIHAASXB 
IHADCB 
IHADCBDF 
IHADECB 
IHADSAB 
THAFRRS 


IHAIQE 
IHAPSA 
IHAPVT 
IHARB 
TIHARMPL 


THASDWA 


THASRB 


IHJSSCR 
IKJRB 
IKJTCB 
XCTLTABL 


Description 

Maps the VS2 input/output block (IOB) 

Maps the VS2 job step control block (JSCB) 

Maps the access-method control block (ACB) 

Maps the exit list (EXLST) 

Maps the request parameter list (RPL) 

Maps the VS2 catalog auxiliary work area (CAXWA) 
Maps the VS2 address space control block (ASCB) 
Maps the VS2 address space extension control block (AS XB) 
Maps the VS2 data set control block (DCB) 

Maps the VS2 data set control block (DCB) 

Maps the VS2 data extent control block (DECB) 
Maps the VS2 data set association block (DSAB) 


Maps VS2 Recovery Termination Manager Dsects for function recovery 
routines 


Maps the VS2 interrupt queue element (IQE) 
Maps the VS2 prefixed save area (PSA) 
Maps the VS2 page vector table (PVT) 

Maps the VS2 request block (RB) 


Maps the VS2 Resource Manager’s parameter list for interfacing with 
VSAM Task Close Executor (IDAOCEA2) 


Maps the STAE diagnostic work area (SDWA, also called the recovery 
termination communication area—RTCA) 


Maps the VS2 service request block (SRB) 


Maps the subsystem control record of areas saved at checkpoint time 
Maps request blocks 

Maps the task control block (TCB) 

Maps the VS2 XCTL table 


This table lists the macros issued by VSAM that generate executable code. 
Macros That Generate Executable Code 


Macro 
ABEND 


ACQRANGE 


BLDVRP 
CATLG 


CLOSE 
CNVTAD 
DEBCHK 
DELETE 
DEQ 
DLVRP 


Description 

Abnormal termination (VS2 macro) 

Stage a range of data from a VSAM data set 
Builds a VSAM resource pool for shared resources 


Loads the address of the catalog parameter list (CTGPL) into register 1 
and issues SVC 26 


VSAM CLOSE: Disconnects a user from a VSAM data set 
Convert key/RRN/RBA to volume serial and RBA 
Checks the validity of the DEB 

(Same as VS2 DELETE macro) 

(Same as VS2 DEQ macro) 


Deletes a VSAM resource pool for shared resources 
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Macros That Generate Executable Code (continued) 


Macro 


DOM 
ENDREQ 
ENQ 
ERASE 
ESTAE 
EXCP 
FREEMAIN 
GENCB 
GET 
GETIX 
GETMAIN 
GTRACE 
IDACALL 


IDACB1 


IDACB2 


IDAERMAC 


IDAEXITR 


IDAGMAIN 
IDAPATCH 
IDAPEMT 
IDARST14 
IDASVR14 
IECRES 
LOAD 
MNTACQ 
MODCB 
MODESET 
MRKBFR 
OBTAIN 
OPEN 
PGFIX 


PGFREE 
POINT 
POST 
PUT 
PUTIX 


Description 

Deletes operator message (VS2 DOM macro) 

Terminates a VSAM record processing request (such as GET or PUT) 
(Same as VS2 ENQ macro) 

Deletes a VSAM record 

Specifies task asynchronous exit (VS2 macro) 

(Same as VS2 EXCP macro) 

Releases virtual storage obtained by a GETMAIN 

Generates a VSAM control block (ACB, EXLST, or RPL) 

Retrieves a record from a data set on a direct-access device 

Retrieves a control interval from the index of a key-sequenced data set 
Obtains virtual storage for a temporary work area 

Calls the Generalized Trace Facility (GTF) to copy VSAM control blocks 


Transfers control from procedure A to procedure B and allows procedure 
B to return control to procedure A at the instruction following the 
IDACALL instruction-expansion 


Transforms operands for Control Block Manipulation macros (GENCB, 
MODCB, SHOWCEB, and TESTCB) 


Scans keywords and generates code for Control Block Manipulation 
macros 


Prints MNOTEs for Control Block Manipulation macro user-programmer 
errors 


Transfers control from VSAM modules to a user’s exit routine and allows 
the user exit routine to return control to the VSAM module at the 
instruction following the IDAEXITR instruction-expansion 


IDAEXITR issues DELETE, IDARST14, IDASVR14, and LOAD. 
Gets virtual storage for VSAM Open, Close, and End of Volume 
Generates maintenance space 

Gives control to End of Volume to preformat a control area 
Puts the return address in register 14 

Saves register 14 in the placeholder (PLH) push-down list 
Transfers control to the VS2Resident routine 

(Same as VS2 LOAD macro) 

Mounts a volume and stages VSAM records into it 

Modifies a VSAM control block (ACB, EXLST, or RPL) 

(Same as VS2 MODESET macro) 

Marks a buffer in a VSAM resource pool 

(Same as VS2 OBTAIN macro) 

Connects a user's program to a VSAM data set 


‘*Fixes” a page of virtual storage so that it remains in real storage for a 
duration 


“Frees” a “fixed” page of virtual storage. 
Identifies a starting point in a VSAM data set 
(Same as VS2 POST macro) 

Writes a record into a VSAM data set 


Writes a control interval in the index of a key-sequenced data set 


Diagnostic Aids 377 


Page of SY26-3825-1 
As Updated March 30, 1979 
By TNL SN26-0932 


Macros That Generate Executable Code (continued) 


Macro 


RESERVE 
RETURN 
SCHBFR 
SDUMP 
SETFRR 
SETLOCK 
SETRP 
SHOWCAT 
SHOWCB 
SMFWTM 
STARTIO 
SYNCH 
TERMRPL 


TESTAUTH 
TESTCB 
TIME 
VERIFY 


WAIT 
WRTBFR 
WTO 
XCTL 


Note: The use of these user macros is described in OS/VS Virtual Storage 


Description 

(Same as VS2 RESERVE macro) 

(Same as VS 2 RETURN macro) 

Searches for a control interval ina VSAM resource pool 
Schedules SVC dump routine (VS2 macro) 

Sets up functional recovery routine (VS2 macro) 
Obtains or releases a lock (VS2 macro) 

Records recovery information (VS2 macro) 


Displays information from a VSAM catalog 


Displays information from a VSAM control block (ACB, EXLST, or RPL) 


Writes the SMF message into the SMF data set 


Gives control to the VS2 I/O Supervisor to start an I/O operation 


(Same as ISAM SYNCH macro) 


Releases owned resources of a terminated RPL and restarts deferred 


synchronous requests 


Checks authorization of a calling module to perform certain functions 
Tests information in a VSAM control block (ACB, EXLST, or RPL) 
Obtains the correct time from the VS2 system time-of-day clock 


Gives control to Record Management to check the end-of-data indicators 
for Checkpoint/Restart or for Access Method Services VERIFY command 


(Same as VS2 WAIT macro) 
Writes buffers from a VSAM resource pool 
Writes a message to the operator (no reply) 


Transfers control (VS2 XCTL macro) 


Access Method (VSAM) Programmer’s Guide: 


CLOSE 
ENDREQ 
ERASE 
GENCB 


SHOWCB 
TESTCB 


The use of these user macros is described in OS/VS Virtual Storage Access 


Method (VSAM) Options for Advanced Applications: 
ACQRANGE 


BLDVRP 
CNVTAD 
DLVRP 
GETIX 


MNTACQ 


MRKBFR 
PUTIX 
SCHBFR 


SHOWCAT 


WRTBFR 
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After an asynchronous request for access to a data set, VSAM indicates in 
register 15 whether the request was accepted, as follows: 


Reg 15 Condition 

0(0) Request was accepted. 

4(4) Request was not accepted because the request parameter list indicated by the 
request (RPL=address) was active for another request. 

After a synchronous request, or a CHECK or ENDREQ macro, register 15 

indicates whether the request was completed successfully, as follows: 

Reg 15 Condition 

0(0) Request completed successfully. 


4(4) Request was not accepted because the request parameter list indicated by the 
request (RPL=address) was active for another request. 


8(8) Logical error; specific error is indicated in the feedback field i.i the RPL. 
12(C) Physical error; specific error is indicated in the feedback field in the RPL. 


Paired with the 0, 8, and 12 indicators in register 15 are return codes in the 
feedback field of the request parameter list. 


The feedback return codes for the 0 indicator in register 15, which doesn’t 
cause VSAM to exit to an exit routine, are: 


RPLFDBK 
Code Condition 


0(0) Request completed successfully. 


4(4) Request completed successfully. For retrieval, VSAM mounted another volume 
to locate the record; for storage, VSAM allocated additional space or mounted 
another volume. 


8(8) For GET requests, indicates that a duplicate key follows; for PUT requests, 
indicates that a duplicate key was created in an alternate index with the 
nonunique attribute. 


12(C) (Shared resources only.) A buffer needs to be written. 


16(10) Control area split was required because a sequence set control interval had free 
space insufficient to contain the key to be inserted. 


20(14) Data set is not on a virtual DASD for MNTACQ/ACQRANGE request. 
Detected by IDA0192E. 


28(1C) ACI split for the CI with the RBA acquired from RPLDDDD which was 
interrupted. The CI was read as nonupdate with address access. This warning 
condition indicates that duplicate data records may exist. 


32(20) Request deferred for a resource held by the terminated RPL is asynchronous and 
cannot be restarted by TERMRPL. 


36(24) Possible data set error condition was detected by TERMRPL: 
1. The request was abnormally terminated in the middle of its I/O operation. 2. 
One of the data/index BUFCs of the string contains data that needs to be written 
(BUFCMW=ON) but it was invalidated by TERMRPL. 


40(28) Error in PLH data BUFC pointer was detected by TERMRPL. 


See the discussions below for the logical-error return codes and for the 
physical-error return codes. 
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Function Codes for Logical and Physical Errors 


When a logical or physical error occurs during processing that involves 
alternate indexes, VSAM provides a code in the RPLCMPON field that 


indicates whether the base cluster, its alternate index, or its upgrade set was 


being processed and whether upgrading was okay or might have been 


incorrect because of the error: 


Code What Was Being Processed 
0(0) Base cluster 

1(1) Base cluster 

2(2) Alternate index 

3(3) Alternate index 

4(4) Upgrade set 

5(5) Upgrade set 


Logical-Error Return Codes 


Status of Upgrading 
Okay 
Might be incorrect 
Okay 
Might be incorrect 
Okay 


Might be incorrect 


When a logical-error-analysis exit routine (LERAD) is provided, it gets 


control for logical errors, and register 15 doesn’t contain 8, but contains the 


entry address of the LERAD routine. 


Figure 57 gives the contents of the registers when VSAM exits to the LERAD 


routine. 


If a logical error occurs and a LERAD exit routine isn’t provided (or the 


LERAD exit is inactive), VSAM returns control to the processing program 
following the last executed instruction. Register 15 indicates a logical error 


(8), and the feedback field in the request parameter list contains a code 
identifying the error. Register 1 points to the request parameter list. 


380.8 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


Reg 


Contents 


2-13 


14 
15 


Unpredictable. 


Address of the request parameter list that contains the feedback field the routine 
should examine. The register must contain this address if the exit routine returns 
to VSAM. 


Same as when the request macro was issued. Register 13, by convention, contains 
the address of the processing program's 72-byte save area, which may not be used 
as a Save area by the LERAD routine if the routine returns control to VSAM. 


Return address to VSAM. 


Entry address to the LERAD routine. The register doesn’t contain the 
logical-error indicator. 


Figure 57.Contents of Registers When a LERAD Routine Gets Control 


Figure 58 gives the logical-error return codes in the feedback field and 
explains what each one means. 
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RPLFDBK 
Code Condition 


4(4) End of data set encountered (during sequential retrieval). Either no EODAD 
routine is provided, or one is provided and it returned to VSAM and the 
processing program issued another GET. 


Detected by: IDA019RA, IDA019RD, IDA019RR, IDAOISRY 
IDA019R2, IDA019R4, IDAO019R8 


8(8) Attempt was made to store a record with a duplicate key. 
Detected by: IDA019RA, IDA019RQ, IDA019RX, IDA019R4, IDA019SE 


12(C) Attempt was made to store a record out of ascending key sequence; record may 
also have a duplicate key. 


Detected by: IDA019RA, IDA019RR, IDA019RX, IDA019R4, IDA019SE 
16(10) Record not found. 

Detected by: IDA019RA, IDA019RR, IDAO19RY 
20(14) Record already held in exclusive control by another requester. 

Detected by: IDA019RF, IDAOISRY, IDA019R2, IDA019R8 
24(18) Record resides on a volume that can’t be mounted. 


Detected by: IDA0O19RW, IDAOI9RY, IDA019R2, IDA019R5, IDAO19SE, 
IDA019SL 


28(1C) Dataset cannot be extended because VSAM can’t allocate additional 
direct-access storage space. Either there isn’t enough space left in the data space 
for the secondary-allocation request or an attempt was made to increase the size 
of a data set by splitting the control area (high used RBA change) during 
processing with SHROPT=4 and DISP=SHR. 


Detected by: IDA0O19RE, IDA019SE 


32(20) An RBA was specified that doesn’t give the address of any data record in the data 
| set. 


Detected by: IDA019RA, IDA019R8, IDA019SG 


36(24) Key ranges were specified for the data set when it was defined, but no range was 
specified that includes the record to be inserted. 


Detected by: IDA019RM 
40(28) Insufficient virtual storage in the address space to complete the request. 
| Detected by: IDA019RG, IDA019RU, IDA019RX, IDA019SH, IGX00006 
44(2C) Work area not large enough for the data record (GET with OPTCD=MVE). 


Detected by: IDA019RR, IDAOI9RT, IDAOISRY, 
IDA019R4, IDA019R8 


48(30) Invalid options, data set attributes, or processing conditions specified for 
TERMRPL request: 


CNV processing P 
The specified RPL is asynchronous 

Chained RPL’s 

PATH processing 

Shared resources (LSR/GSR) 

Create mode 

RRDS 

Data set contains spanned records 

User not in Key 0 and Supervisor state 

EOV in process (Secondary allocation) 


Detected by: IDA019SN 


Figure 58 (Part 1 of 4). Logical-Error Return Codes in the RPL Feedback Field 
from a Request Macro 


382 OS/VS2 Virtual Storage Access Method (VSAM) Logic 


RPLFDBK 


Code 
52(34) 


64(40) 


Condition 
The previous request was TERMRPL. 
Detected by IDA019SN 


As many requests are active as the number specified in the STRNO parameyer of 


the ACB macro; therefore, another request cannot be activated. 


68(44) 


72(48) 


76(4C) 


80(50) 


84(54) 


88(58) 


92(5C) 


96(60) 


100(64) 


104(68) 


Detected by: IDA019RU, IDA019RX, IDA019R1 


Attempt was made to use a type of processing (output or control-interval 
processing) that was not specified when the data set was opened. 


Detected by: IDA019RQ, IDA019R4, IDA019R8 


A keyed request for access was made to an entry-sequenced data set or a GETIX 
or PUTIX was issued to an entry-sequenced or relative record data set. 


Detected by: IDA019R1, IDAO19R8 


An addressed or control-interval PUT was issued to add a record toa 
key-sequenced data set, or a control-interval PUT was issued to a relative record 
data set. 


Detected by: IDA019R1, IDA019R8 
An ERASE request was issued for access to an entry-sequenced data set. 
Detected by: IDA019RL, IDA019RX, IDA019R8 


OPTCD=LOC was specified for a PUT request or in a request parameter list in a 
chain of request parameter lists. 


Detected by: IDA019RQ, IDA019R1, IDA019R4, IDA019R8 


A sequential GET or PUT request was issued without VSAM having been 
positioned for it, or a change was made from addressed access to keyed access 
without VSAM having been positioned for keyed sequential retrieval, or an 
illegal switch between forward and backward processing was attempted. 


Detected by: IDA019RQ, IDA019RR, IDA019R4, IDA019R8 


A PUT for update or an ERASE was issued without a previous GET for update, 
or a PUTIX was issued without a previous GETIX. 


Detected by: IDA019RQ, IDA019RX, IDA019R4, IDA019R8 

Attempt was made to change a key during an update. 

Detected by: IDAO19RL, IDA0O19RX 

Attempt was made to change the length of a record during an addressed update. 
Detected by: IDA019RL, IDA019RQ 

The RPL options are either invalid or conflicting in one of the following ways: 

° SKP was specified and either KEY wasn’t specified or BWD was specified 
° BWD was specified for CNV processing 

e FWD and LRD were specified 

° Neither ADR, CNV, nor KEY was specified in the RPL 


e WRTBFR, MRKBFR, or SCHBFR was issued, but either TRANSID was 
greater than 31 or a shared-resources option wasn’t specified 


2 ICI processing was specified, but a request other than a GET or a PUT 
was issued 


Detected by: IDA019RA, IDA019RR, IDAOI9RY, IDA019RX, 
IDAO19R1, IDA019R4, IDA0198 


Figure 58 (Part 2 of 4). Logical-Error Return Codes in the RPL Feedback Field 


from a Request Macro 
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RPLFDBK 


Code 
108(6C) 


112(70) 


116(74) 


132(84) 


136(88) 


140(8C) 


144(90) 


148(94) 


152(98) 


156(9C) 


Condition 


RECLEN specified was larger than the maximum allowed, equal to 0, smaller 
than the sum of the length and the displacement of the key field, or not equal to 
record (slot) length specified for a relative record data set. 


Detected by: IDA0OI9RL, IDAO19RQ, IDAO19RU, 
- IDA019R4, IDA019R8 


KEYLEN specified was too large or equal to 0. 
Detected by: IDA019R1 


A GET, POINT, ERASE, direct PUT, skip sequential PUT, or PUT with 
OPTCD=UPD not permitted during initial data-set loading (that is, for storing 
records in the data set the first time it’s opened). 


Detected by: IDA019RR, IDA019R4, IDA019R8 

An attempt was made in locate mode to retrieve a spanned record. 

Detected by: IDAO19RT 

An addressed GET was issued for a spanned record in a key-sequenced data set. 
Detected by: IDA019RT 

Inconsistent spanned-record segments. 

Detected by: IDA019R4 

Invalid pointer in an alternate index (no associated base record). 

Detected by: IDAOI9RX 

The maximum number of pointers in the alternate index has been exceeded. 
Detected by: IDA019RU 

(Shared resources only.) Not enough buffers are available to process the request. 
Detected by: IDAOI9RY 


An invalid Control Interval was detected during keyed processing. The invalid 
conditions possible are: 


A key is not greater than the previous key. 

A key is not in the current control interval. 

A spanned record RDF is encountered. 

A freespace pointer is invalid. 

The number of records does not match a group 
RDF record count. 


Detected by: IDAO19RA, IDAO19RV, IDA019R4, IDA019S6 


WVhwWwn = 


Figure 58 (Part 3 of 4). Logical-Error Return Codes in the RPL Feedback Field 


from a Request Macro 
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RPLFDBK 
Code Condition 
164(A4) Invalid options specified for CNVTAD/MNTACQ/ACQRANGE request: 


168(A8) 


172(AC) 


176(BO) 


180(B4) 


184(B8) 


188(BC) 


192(CO) 


196(C4) 


200(C8) 


204(CC) 


208(DO) 


- Generic key (GEN) 

. Create mode 

° Path processing 

° User buffers (UBF) with LSR/GSR 

° KSDS but not key processing (KEY) 

° ESDS but not address processing (ADR) 

° RRDS but not key processing (KEY) 

° IMBED data set with only one level of index. 
Detected by: IDAO19R1 


User parameter list errors detected for CNVTAD/MNTACQ/ACQRANGE 
request: 


° No user parameter list is specified (RPLARG=0) 

° Argument count = zero for CNVTAD/MNTACQ request 

° Ending argument is less than starting argument for ACQRANGE request 
° Parameter list is not on word boundary. 

Detected by: IDA019R1, IDA019SH 


ACQUIRE immediate errors returned by SVC 126 for MNTACQ/ACQRANGE 
request. 


Detected by: IDA0192E 
Staging failure for MNTACQ/ACQRANGE request. (MSS hardware errors.) 
Detected by: IDA0N19SM 


RBA/Volume error for MNTACQ/ACQRANGE request. (Required volume not 
mounted or specified RBA(s) not on mounted volume.) 


Detected by: IDA019SL, IDA0192E 

Catalog errors returned from SVC 26 for CNVTAD request. 
Detected by: IGX00006 

Storage in subpool 241 is not available for MNTACQ or ACQRANGE request. 
Detected by: IDA0192E 

Invalid relative record number. 

Detected by: IDA019RQ, IDA019RR 

An addressed request was issued to a relative record data set. 
Detected by: IDAO19R1 

Addressed or control-interval access was attempted by way of a path. 
Detected by: IDAO19RX 

PUT-insert requests are not allowed in backward mode. 

Detected by: IDA019RQ, IDA019R4 

Invalid ENDREQ request. 

Detected by: IDA019SM, IDA019RP 


Figure 58 (Part 4 of 4). Logical-Error Return Codes in the RPL Feedback Field 


from a Request Macro 
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Field Bytes Length Discussion 


Message 91 105 15 


Messages are divided according to ECB condition 
codes: 

xX*417— 

“UNIT EXCEPTION” 
““PROGRAM CHECK’”’ 
“PROTECTION CHK” 
““CHAN DATA CHK” 
‘““CHAN CTRL CHK’”’ 
‘“INTFCE CTRL CHK” 
““CHAINING CHK’”’ 
“UNIT CHECK”’ 


If the type of unit check can be determined, this message is replaced by one of the 


following: 

106 1 
Physical 107 120 14 
Direct-Access 
Address 


121 1 
Access Method 122 127 6 


“CMD REJECT” 

“INT REQ” 

“BUS OUT CK”’ 

““EQP CHECK”’ 
“DATA CHECK” 
“OVER RUN” 
“TRACK COND CK”’ 
“SEEK CHECK” 
“COUNT DATA CHK” 
“TRACK OVERRUN” 
““CYLINDER END” 
“INVALID SEQ” 

““NO RECORD FOUND” 
“FILE PROTECT”’ 
“MISSING A.M.” 
““OVERFL INCP”’ 


X*°48’—"“PURGED REQUEST” 
X‘4F’—“R.HA.RO. ERROR”’ 


For any other ECB completion 
code—“UNKNOWN COND.” 


Comma (,) 


BBCCHHR (bin, cylinder, head, 
and record) 


Comma (,) 


“VSAM” 


Figure 61 (Part 2 of 2). Format of Physical-Error Messages 


Open and Close Return Codes 


When a processing program receives control after it has issued an OPEN or 
CLOSE macro, register 15 indicates whether all of the data sets were opened 


or closed successfully: 
Reg 15 Condition 


0(0) All data sets were opened or closed successfully. 


4(4) Open: all data sets were opened successfully, but one or more warning messages 
were issued (ACBERFLG codes less than X‘80’). 
Close: at least one data set (VSAM or nonVSAM) was not closed successfully. 


8(8) Open: at least one data set (VSAM or nonVSAM) was not opened successfully; if 
there was an error for an ACB, it was restored to the contents it had before 


OPEN was issued. 


12(C) Open: at least one data set (VSAM or nonVSAM) was not opened successfully; if 
there was an error for an ACB, it was not restored to the contents it had before 
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OPEN was issued (and the data set cannot be opened without the ACB’s being 
restored). 
ACBERFLG Code Condition 
0(0) When register 15 contains 0: 
All data sets were opened or closed successfully 
When register 15 contains 8: 
Either VSAM is processing the ACB for some other request, 
Or DDNAME was not specified in the ACB 
4 (4) Warning message: the ACB is already opened (and the user issued 
OPEN), or the ACB is already closed (and the user issued CLOSE 
or temporary CLOSE). 
96 (60) Warning message: an unusable data set was opened for input. 
Detected by: IDA0192B 
100 (64) Warning message: Open encountered an empty alternate index ¥ 
that is part of an upgrade set. 
Detected by: IDA0192B 
104 (68) Warning message: the timestamp for the volume does not match 
the timestamp in the catalog record for the data set. (This may 
mean the cluster existing on the volume(s) is not accurately 
described by its catalog record.) 
Detected by: IDA0192A 
108 (6C) Warning message: the timestamp for the index is less than the 
timestamp for the data set. (This could occur if the data set was 
updated without the index being open.) 
Detected by: IDA0192B 
116 (74) Warning message: the last request to close this data set was not 
completed successfully. 
Detected by: IDA0192B 
128 (80) DDNAME not found in TIOT. 
132 (84) An I/O error was detected while the system was reading the JFCB. 
Detected by: IDA0192F, IDA0200V 
136 (88) Not enough storage was available for work areas, buffers, or 
control blocks. 
Detected by: IDA0192A, IDA0192B, IDA0192C, IDA0192F, 
IDA0192W, IDA0192Y, IDA0192Z, IDA0200B, 
IDA0200T, IDA0231B, IDA0231T 
144 (90) An I/O error occurred while a catalog record was being read or ; 
written. A return code was set by a VS2 Catalog-Management 
routine. 
Detected by: IDA0192C : 
148 (94) The catalog entry for the data set being opened or closed was not 
found or an unidentified error occurred while VSAM was 
searching the catalog. 
Detected by: IDA0192C 
152 (98) The data set being opened is protected by a password, and the 
VSAM Open routine was unable to validate the password or an 
unauthorized program is attempting to open a catalog as a data 
set. 
Detected by: IDA0192C 
160 (AO) The buffer space specified was not consistent with the buffer 


requirements of the data set; or the ACB indicated keyed access, 
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Condition 


but the data set is not a key-sequenced data set; or the device type 
specified in the DD statement is not consistent with the device type 
indicated in the catalog entry for the data set; or user buffering is 
specified in the ACB’s MACRF field and control-interval 
processing should be specified, but is not. 


Detected by: IDA0192A, IDA0192B, IDA0192C, IDA0192Z 
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Error ABEND Error indication set 
detected issued in DCB or DECB by 
ABEND Error by by 
1(001) The user did not specify a SYNAD exit routine. 
(a) I/O error VSAM BISAM SYNAD (DECB) 
initially (ID AIIPM3) (IDAITISM1) 
and BISAM 
during 
CHECK 
(b) Invalid BISAM © BISAM BISAM (DECB) 
request 
49(031) The user did not specify a SYNAD exit routine. 
(a) VSAM physical VSAM SYNAD SYNAD 
or logical 
error 
(b) Invalid VSAM SYNAD GET and SETL 
request routines of SCAN 
(IDAIIPM2) 
(c) Sequence LOAD LOAD RESUME routine of 
check (IDAIIPM 1) LOAD 
(d) Length error LOAD LOAD LOAD 
(RDW greater 
than LRECL) 
57(039) End of data VSAM SCAN EODAD routine 
without EODAD (IDAIIPM2) of SCAN 
routine 
58(03.A) VSAM ACB CLOSE CLOSE CLOSE 
closed (IDA0200S) 
with warning 
messages 
59(03B) Validity check OPEN OPEN Validity-check 
(IDA0192I) routine of OPEN 


Catalog values and DCB values for LRECL, KEYLE, or RKP don't correspond, or, 
with QISAM, DISP is specified OLD when the data set is being opened for output, 
and there are already records in the data set (implying RELOAD). 


Figure 67. ISAM-Interface ABENDs 
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Exception codes may be set in the DCB (for QISAM processing) or the 
DECB (for BISAM processing) in connection with ISAM-Interface ABENDs. 
Figures 68 and 69 give the exception codes. Except where indicated, register 
15 contains 8, for logical errors. 


DECB Corresponding Error 
exception RPL feedback detected 
code Explanation code(s) Explanation By 
DECBEXC1 
| eee Record not found 16(10) Record not found VSAM 
24(18) Record on VSAM 
| unmountable volume 
mi |e Record-length 108(6C) Record-length VSAM 
check check 
a oes Space not found 28(1C) Data set not VSAM 
extendable 
cA ele Invalid request none No RPL available ISAM 
Interface 
20(14) Exclusive-control VSAM 
conflict 
36(24) No key range VSAM 
defined for 
insertion 
64(40) Placeholder not VSAM 
available 
96(60) Key-change VSAM 
attempted 
ea re Uncorrectable 4-24 A physical error VSAM 
I/O error (04-18) (Register 15 
contains 12(0C)) 
emillgg Unreachable — A logical error VSAM 
block not covered by 
another exception 
code 
onl Overflow record none ISAM 
(indicated for-all Interface 
READ requests) 
ee 1 Duplicate record 8(08) Duplicate record VSAM 
- DECBEXC2 
XXXX XX.. Reserved (always none 
0) 
wells Channel program none 
initiated by an 
asynchronous routine 
(never indicated, 
always 0) 
the ees 1 Previous macro was none ISAM 
READ KU Interface 


Figure 68. BISAM Exception Codes in Relation to VSAM Return Codes 
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